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特製 ライブラリの 
作成 方法 




MSX- C の 標準 ライ ブラ リに は， MSX の 機能 を 支援す るた めの， 
グラフ ィ ックス を 极ぅ閤 数， あるいは ジョイ ス ティ ックゃ マウス を 
読み取る M 数 はまった く 用意され ていません. そこで， 本書で はゲ 
—ムの プロ ダラ ミ ングに 必要な これらの 関数 を 作成し， 特製 ライブ 
ラリの 形に まとめて 利用し ます. 特製 ライブラリ は， 

MSXALIB.REL '… アセンブラで 作成され た ライブラリ 
MSXCLIB.REL …… C 言語で 作成され た ライ ブラ リ 

の 2 つの ファイルより 成り立って います. この 章で は， 特製 ライブ 
ラリの 作成 方法 を 説明し ます. 




ライ ブラ 1 J 作成 I 
必要な ファイル 



つ 
レ 



ライブラリ を 作成す るに は， 以下の フ アイ ルを 用意す る 必要が あ ります. 
卷 末に 付録と して これらの リストが まとめて 掲載され ています から， それ ぞ 

れ 指定した とおりの ファイル 名で MSX-DOS で 動く テキス ト エディ タを使 
つて 打ち込んで ください. 、、AMAKE. BAT" *CMAKE. BA で "ACHG. 
BAT" 、、CCHG. BAT* の 4 つの フ アイ ルは， DOS のバ— ジョン （MSX-DOS 
か MSX-D0S2 力、） によって異なる もの を 使用し ますので、 お 手元の DOS の 
種類に 合った リストの ほう を 選んで ください. そして， 作成した ファイル は 
作業用 ディスク を 1 枚 作って， そこに まとめて おきましょう， 



MSXALIB.MAC …… アセンブラ 記述 ライブラリ （MSXALIB.REL) の ゾ一ス 
AMAKE. BAT …… MSXALIB. REL を 作成す るバッ チ プロ グラム 
ACHG.BAT …… MSXALIB.REL の一 部 を 更新す る バッチ プログラム 
MSXCLIB.C …… MSX-C 記述 ライブラリ （MSXCLIB. REL) の ソース 
CMAKE. BAT …… MSXCLIB. REL を 作成す る バッチ プログラム 

CCHG. BAT -… MSXCLIB. REL の一 都 を 更新す る ノ、' ッ チ プロ グラム 



特製 ライブラリ の 作成に は， 以下の コマンド フ アイ ルぉ よ び 関連 フ アイ ル 
も 必要です. これら も 忘れずに 用意して， 作業 ディスクに コピーし ておいて 
ください. ただし MSX-DOS 2 をお 使いの 方 は、 "ECH0.COM クは 必要 あり 
ません. なお や LIB 80. COM* と AM80.COM" は 『MSXDOS TOOLSj 
に， それ 以外 は 『MSX-C』 の システム ディスクに 含まれて います. 



LIB80.COM …… ライブラリ 作成 保守 コマンド 

M80.COM …… アセンブラ 

MX.COM …… モジュール 抽出 コマンド 
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2 章 特製 ライブラリの 作成 方法 



CF. COM …… MSX-C パ一サ 

CG. COM …… MSX-C コード ジェネレータ 

ECH0.COM …… ファイルに 文字列 を 追加す る （MSX-D0S2 では 必要なし） 
AREL.BAT … … MX. COM が 使 う データファイル 
CREL.BAT … … MX, COM が 使 う データファイル 
STDI0.H …… MSX-C の インクルード ファイル 

^ 特製 ライブラリ の 作成 手順 

本書で 作成す る 特製 ライ ブラ リは， アセンブラで 記述した 部分と， MSX-C 
で 記述 し た 部分の 2 つに わかれて い ま す. 

• WSXALIB.RE じ の 作成 手順 

まず 最初に， アセンブラ 記述 ライブラリ "MSXALIB.RE ひの 作成 方法 を 
説明し ましよ う. ここに は， BIOS コール 関数 や， 特に 実行 スピードの 速さが 
要求され る 関数が 含まれて います. ソース プログラム 、、MSXALIB.MA(7 
から ライブラリ や MSXALIB.REI/ を 完成させる に は 次の 手順が 必要です. 



MSXALIB.MAC 

一 I …… （1) MX で モジュール を 分割す る 



各モジ ユー 


ル. MAC 




各モジ ユ- 





(2) M 30 で それぞれ を アセンブル する 



_ _ i …… (3) LIB 80 で ライブラリ 化する 

MSXAL1B.REL 

以上 を オートマチックに 実行す る バッチ ファイルが や AMAKE.BAT" で 
す. アセンブラの ソース *MSXALIB，MAC* を 入力して， この バッチ ファ 
ィルを 実行 すれば， 次のように すべての 処理が おこなわれ， 最終的に 
、、MSXALIB. REI/ が 完成し ます. 
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2. 2 ライブラリ 作成に 必要な ファイル 



A> amake 



• や MSXCUB.RE ビ の 作成 手順 

もう ひとつの ライブラリ や MSXCLIB. REL" は， MSX-C で 記述され てい 
ます. ソース プロ ダラム *MSXCLIB.C 〃から ライブラリ "MSXCLIB.REI/ 
を 完成させる に は 次の 手順が 必要です. 



MSXCUB.C 

1 …… （1) CG で TCO フ アイ ノレ を 作成す る 
MSXCLIB.TCO 

I -… •• (2) MX で モジュール ごとに 分割す る 
各 モジュール. TCO 

i …… （3) CG で アセンブリ 言語に 変換す る 

各乇 ジュ" ル * M AC 

I …… （4) M 80 で アセンブル する 
各^ ジュール *REL 

1 …… （5) LIB80 で ライブラリに まとめる 
MSXCLIB.REL 



以上 を オートマチックに 実行す る バッチ ファイルが *CMAKE.BAT〃 で 
す. MSX-C の ソース、、 MSXCLIB.C" および "MSXALIB.IT, MSX-C の 
標準 インクルード ファイル 、、STDI ひ H" を 用意して， この バッチ ファイル を 
実行 すれば， 次のように すべての 処现が おこなわれ， 最終的に *MSXCLIB. 
REI/ が 完成し ます. 



A> cmake 
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2 章 特製 ライブラリの 作成 方法 



\ 特製 ライ ブラ リ の 利用 前の 準備 

特製 ライ ブラ リ を 使って いる プロ グラム をコ ン パイ ル する 場合に は， コ ン 

パイル 用 バッチ プログラム 、、CC.BAT" を リスト 2.1 のように 変更して くだ 
さい. 

ま た， 2 つの ライ ブラ リファイ ル それぞれ に対して， ライブラリ に 含まれる 
関数の 宣言 をお こなう ヘッダー フ アイ ルが 必要です. 卷 末に 

MSXALIB,H および 
MSXCLIB.H 

として 揭 載して あります から、 これら を 入力し 、、MSXALIB. IT および 
や MSXCLIB. IT という フ アイ ル名 をつ けて 保存して く ださ い. 
以上て 嚼 製 ライブラリ を 利用す るた めの すべての 作業の 完了です 



cf y.i 

eg Xi 

m80 

d«l Xl.tco 

180 ck,5U,Bisxclib/8,max*lib/B,cUb/s,cmn/B,cend, Xt/n/« 
del Xl, 鼉" 
dol Xl.rel 

リス 卜 2.1 CC.BAT 





ライブラリ 守 



、、MSXALIB, REI/ や *MSXCLIB. REI/ の 作成 は， 最初から 最後まで 
通して おこなう と， たいへん 時間が かかります. ですから， ソース プロ ダラ 
厶 を 更新す る た びに すべて を やり 直す の は ひ ど く 手間 な 作業です. そ こ で， 
1 つの 関数の ソース プログラム を 更新したならば， その 閧数 だけにつ いて 再 
コンパ ィ ノレ， あるいは 再 アセンブルして， 現存す る ライブラリと 差し替える 
ための バッチ プロ ダラム を 用意し ました. ソース プログラムの一 部分 だけ 訂 
正す るよう な 場合に 利用して ください. 

や MSXAUB.REI/ を 更新す る 場合に は や ACHG.BAT* を 使用し ます. 
たとえ ば line 闋 数の モジュール を 変更す るなら 次のように 入力し ます， これ 
で "MSXALIB. REIZ の 中の line 関数 を 更新す る ことができます. 



A> achg line …… MSXALIB. REL の 中の line 関数 を 更新す る 



"MSXCLIB. REL" の 更新に は TCHG. BAT" を 使用し ます， たとえ ば 
screen 閧 数の モジュール を 変更す るなら 次の よ うに 入力し ます. これで 
や MSXCLIB. REI/ の 中の screen 関数 を 更新す る こ と がで き ます. 



A> cchg screen …… MSXCLIB. REL の 中の screen 関数 を 更新す る 
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S 章 

特製 ライブラリ 関数の 説明 




特製 ライ' ブラ リの 入力から 作成まで， うまく 終了した でしよう か. 
ごくろう さ-まです. あれ ま， コンパイル エラーば かりで る？ そう 
いう 人 は， あまり 根 をつ めずに 時間 をお いて， 再び 入力した ソース 
プログラム を チェックして ください. きっと， どこかに 入力 ミスが 
ある はずです から， 

さあ， ここから は 実際に 特製 ラ ィ ブラ リ の 使い方 を 見て い きまし 

よ う. 本章 は， 28 個 ある ライ ブラ リの 完全 リ ファレン ス マニュアル 
になって います， 各 関数の 使い方 はもと より， 多くの ものに は サン 
プル プログラムが 揭敝 されて います ♦ 実際に 入力して， いろいろ 試 
してみ てくだ さい， 




特製 ライ ブラ 1 」 の 全 関数 



特製 ライ ブラ リには 次に 示した ように， いくつかの カテゴリーに 分類で き 

る 全 28 種類の 関数が 用意され ています. 各 関数の 解説 は， この 章で 1 つず つ 
懇切 丁寧に まとめて あります. サンプル プログラム など を 併用して， 十分 使 
い 方 を 覚えて ください. 

• ゲームで 使われる 関数 

rnd() …… 乱数 を 生成す る 

srnd{) …… 乱数 系列 を 変更す る 

sgn() …… 数値の 符号 を 調べる 
• グラフィックに 関係す る もの 

ginitO …… グラフィック を 使用す る 前の 初期設定 

screen () … … 画面の モード を 設定す る 

color () …… 画面の カラ一 を 設定す る 

palettO …… バ レツ ト を栾更 する 

lineO …… グラフ ィ ック 画面に 直線 を 引く 

boxfilO …… グラフィック 画面の 長方形 を 塗りつ ぶす 

cpym2v() …… グラフ ィ ック 画面に パターン を 表示す る 

cpyv2v() …… グラフィック 両面の バタ一 ンを 移動させる 
• ス ブライ トに 関係す る もの 

inisprO …… ス プライ ト を 初期 ィ 匕し サイズ を 決定す る 

sprite () …一 ス プライ ト パターン を 定義す る 

putsprO …… ス ブライ トを 表示す る 

colsprO …… スプ ライトの 1 ライン ごとの 色 を 指定す る 
•VRAM に 関係す る もの 

vpokeO …… VRAM へ 1 バイ 卜の データ を 書き込む 

vpeek () • … • • VRAM か ら 1 バイトの データ を 読み出す 

IdirvmO …… VRAM へ一 度に 大量の データ を 書き込む 

IdirmvO …… VRAM から 一度に 大量の データ を 読み出す 

filvrmO …… VRAM の 連続した 範囲 を 一定の データて 难 める 
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3 窣 特製 ライブラリ 関数の 説明 
• 入力に 関係す る もの 



snsmatO •• 


…^ 押された キー を 即座に 読み取る 


kilbufO •• 


一 キーの 先 読み バッファ をク リアす る 


gtstckO '• 


-… ジョイスティックの 状鵝を 読み取る 


gttrigO •• 


…- トリガ一 ボタンの 状態 を 読み取る 


gtpad() ，' 


…- マウスの 状態 を 読み取る 


• PSG に 関係す る もの 


gicini() '- 


'… PSG を 初期化す る 


sound () 


… いろいろな 音程の 音 を 鳴らす 


• BIOS に 関係す る もの 


calbio () 


… ROM-BIOS を 呼び出す 


、凡例 





こ の 章で は 以下の 形式に 従つ て ライブラリ 関数の 説明 をお こ ない ま す, 



screen 蘭 数 



関数の 名前 



【機能】 画面 モー ドの 設定 …… 鬨 数の 動作 を ひと ことで 言う 

【仕様】 include <msxclib. h> 必要な へ ッ ダ一 ファイル 

VOID screen (md) …… 閧 数の 呼び出し 方 

TINY md; …… バラ メータの データ 型 

【鋭 明】 

《説明文》 "-… 関数の 動作の 詳しい 説明 

, い'， • :.'、••:' -. 、 ,. '； ：/ 
【用例】 

' ノ％ 文/に ノ パぉ: …一 プログラムの 内容の 解説 

； 編馳麵 讓鍾, ！ 
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3. 1 特製 ライブラリの 全閱数 



rnd 関数 



【機能】 乱数 を 生成し ます 

【仕様】 #include <msxalib. h> 
unsigned rnd in) 

unsigned n; …… 1 から 65535 ま での 整数 

【鋭 明】 

0 から n-1 までの 範囲で ランダムな 整数 を 返します. 乱数 は ゲームに は不 
可 欠な ものです が， MSX-C に は BASIC のよ う に 手軽に 利用で き る 乱数が あ 
りません， そこで 用意した のが この rnd 関数です， これ は ある 数式に 従って 整 
数 を 順次 発生 させて いるもので， 完全な 乱数と はいえ ません， しかし 実用 上 
はこれ で 十分です. 

【用例】 

10 個の 舌し 数 を 表示し ます. 

乱数と はいっても， 実行す る ごとに 同 じ 数列が 表示 される こと に 気付かれ 
たと 思います， なぜなら， この rnd 関数 は， ある 数式に より 次々 と 数 を 計算し 
ていく のです が， その 乱数の 種 （いちばん 最初の 値） に 必ず 同じ もの を 使う 
か ら です. こ れ では 何度 ゲーム をしても 毎回 まったく 同じ 進行と いう ことに 
もな りかね ません. そこで 利用す るの が， 次で 紹介す る srnd という 閧 数です. 
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3 章 特製 ライブラリ 関数の 説明 



¥ include <stdio.h> 
# include く msxalib.h> 

VOID mainO 
{ 

int i, r; 

for (i = 0; i < 10; ++i) { 
r = rnd(i000); 
printf( M X3d 〜 r); 



リスト 3.1 RND.C 
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3. 1 特製 ライブラリの 全 関数 



srnd 関数 



【機能】 乱数 系列 を 変更し ます 

【仕様】 #include く msxalib. h> 
VOID srnd ( ) 

【説明】 

この 関数 は 発生す る 乱数の 並び を 変化させます. 1/60 秒 ごとに カウント ァ 
ップ する ハードウェア カウンタ を 乱数の 種に 利用す るた め， 閧 数の 実行 後 ど 
のよう な 乱数 系列 か 1 辱ら れ るか は， まったく 予測が つきません. ゲームの 敵 
の 動き を决 める 場合な どに は 格好の もので しょ う. 

【用例】 

rnd 関数の サンプル プロ グラムに， srnd 関数 を 付け足 した も のです. 
実行す ると， 毎回 異なる 10 個の 乱数 を 表示し ます. 実行す る ごとに 乱数 列 
が 変^^す る ところに 注目 して く ださい. 





霧 include <stdio,h> 






•include <mBX&lib.h> 




2 


•include <msxclib.h> 




3 










VOID maiiiO 




5 


{ 






6 




int i, r; 












8 






… この srnd 関数に 注目 


9 




for (i = 0; i < 10; ++i) { 




10 




r - rixd(100«l)j 




11 




printf( M X3d r); 




12 




> 




13 









リスト 3.2 SRND.C 
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3 牽 特製 ライブラリ 関数の 説明 



p sgn 関数 



【機能】 数値の 符号 を 調べます 

【仕様」 #include <msxclib. h> 
int sgn (n) 

int n; …… -32768 〜十 32767 の 整数 

【説明】 

sgn 関数 は 引き渡された パラメータの 数値 力 < 正の 数のと き は 1， 0 のとき は 
0, 負の 数のと き は- 1 の 値 を 返します. この 関数 は 移動 方向 や 対象 物の 存在す 
る ベクトル 方向な ど を 知る のに 利用され ます. 

【用例】 

ランダムな 位置に 現れた 文字が 画面の 中央に 向かって 動いて いきます. 

最初に 定義して いる plot 闋数 は， 座標 （x,y) に 文字 ch を 表示させる ための 
ものです. main 関数の for 文で は， まず 舌 L 数で 最初の 位置 （x, y) が 決まり ま 
す. この あと， x 座標に ついては， 「x 十二 sgn(20-x)」 という 式で 次の 位置 
を計箅 します. これ は sgn 閼 数の 働きに よって， 「x が 20 より 小さければ 1 を 
加え， x が 20 より 大きければ- 1 を 加え， x が 20 に 等しければ 0 を 加える」 と 
いう 意味になります から， この 計算 を 繰り返せば， x の 値が なんで あっても 最 
終 的に は 20 に 収束す る わけです. 同様に y 座標 も 「y += s g n(10-y)」 とい 
う 計算 を橾り 返す ことで， 最終的に 10 に 向かって 収束して いきます. 
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3. 1 特製 ライブラリの 全 関数 



0： 


# include <stdio;h> 




1 * 


# include <msxalib.h> 




2: 


# include <msxclib*h> 




3: 

A • 


VOID plot(x, y, ch) 


座標 （x,y) に 文字 ch を 表示す る 


5: 


int 


x, y, ch; 




6: 


{ 




y+32, x+32, ch); 


7- 




printf( "¥33YXcXcXcfe" , 


8: 








9: 








10' 


VOID mainO 




11 


{ 






12 




int x, y, c; 




13 








14 




8rnd(); 




15 




puts("¥33x5¥f n ); 


カーソル 消去， 画面 ク リア 


16 








17 




for (c = は》; c <= } 1 } 


； ++c〉 { 


18 




x - md(40); 




19 




y - rnd(22); 




20 




do { 




21 




plot(x, y , ' 1 


); 

x); 次の X 座 擦 を 計算 


22 




x += sgn(20 - 


23 




y += sgn(10 - 


y); 次の y 座穰を 計算 


24 




plot(x, y, c) \ 


1 y != 10); 


25 




} while (x != 20 1 


26 








27 









リスト 3,3 SGN.C 
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3 章 特製 ライブラリ 関数の 説明 



，、gmit 関 数 



【機能】 グラフ ィ ックを 使用す る 前の 初期設定 

【仕 fej iinclude <msxalib. h> 
VOID ginit ( ) 

【説明】 

ginit 関数 は， VDP の ポート アドレス を 調べる 関数です. この 後で 述べる い 
く つかの グラフ ィ ッ ク 処理 関数 は， I/O ポー ト を 通して VDP を 操作す るた め, 
それらの 関数 を 使用す る 前に は ginit 関数 を 必ず 呼び出さなければ なり ませ 
ん. 

ポート と は CPU が 外部の 装置と データ を やり と りする ために 必要な 窓口 
と 思って ください. VDP の 他に も， プリンタ や フロッピ一 ディスク など， さ 
まざ ま な 装置が そ れ ぞれの ポー トを 通し て CPU とつな がって います. 

ほとんどの MSX では， VDP の ポート は 決まった 位置 （ポート アドレス） に 
あります が， ごく 一部の 機種， あるいは バージョンアップ アダプタ を 使用し 
たと き は 異なる 可能性が あります. そのような 場合に 備えて， VDP の ポート 
アドレス を 調べる の 力 《， ginit 閧 数です. 

よ り 信頼性の 髙ぃ プログラムに する ために も， この ポート ァ ドレス は 必ず 
調べて ください. 

【用例】 

次の 各 関数の 項 を 参照 してく ださい， 

palettO HneO boxfil() cpym2v() cpyv2v() 

vpokeO vpeek() ldirvm() IdirmvO filvrmO 
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3. 1 特製 ライブラリの 全 関数 



screen 関数 



【機能】 画面の モード を 設定し ます 

【仕様】 include く msxclib. h> 

VOID screen \md) 

int md; …… 画面 モー ド 番号 

【説明】 

使用す る 画面 モード を 指定し ます. この 関数 は， MSX BIOS の 005Fh をコ 
—ル する ことで 実現して います. 

SCREEN 0〜3 はすべ ての MSX 機種で， SCREEN 4〜8 は, MSX 2/2+ で, 
SCREEN 10〜12は1^5乂2+以降で使用できます. パラメータ md が 示す 画 
面 モードの それ ぞれの 機能 は 表 3 • 1 のとお りです. 





ノ 

、ふ" お 




謹纖 讓麵き 


麵霸 


SCREEN 


0 




テキスト 




80 (40) X 24 文字 


512 色 中 2 色 


SCREEN 


1 




テキスト 




32X24 文字 


512 色 中 16 色 


SCREEN 


2 




グラフ ィ 


ッ ク 


256X192 ドッ ト 


512 色 中 16 色 


SCREEN 


3 




グラフ ィ 


ック 


64X48 ト' ッ ト 


512 色 中 16 色 


SCREEN 


4 




グラフ ィ 


ッ ク 


256X192 ドッ ト 


512 色 中 16 色 


SCREEN 


5 




グラフ ィ 


ック 


256X212 ドッ ト 


512 色 中 16 色 


SCREEN 


6 




グラフ ィ 


ック 


512X212 ドッ ト 


512 色 中 4 色 


SCREEN 






グラフ ィ 


ック 


512X212 ドッ ト 


512 色 中 16 色 


SCREEN 


8 




グラフ ィ 


V ク 


256X212 ドッ ト 


256 色 


SCREEN 


10 




グラフ ィ 


、ンク 


256X212 ドッ ト 


12, 499 色 


SCREEN 


11 




グラフ ィ 


ック 


256X212 トツ ト 


12. 499 色 


SCREEN 


12 




グラフ ィ 


ッ ク 


256X212 ドッ ト 


19, 268 色 


注： グラフ ィ ッ 


クの 画面 モ- 


-ドを 使用したら， 最後に 必ず テキストの 豳面 モード 



にも どして ください. 

表 3.1 画面 モード 一 K 
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3 章 特製 ライブラリ 閧 数の 説明 



もっとも， こんなに 多ぐ の 画面 モードが あっても， 使いやすい モード は 限 

られ ています. ゲームの プロ ダラ ミ ングに は SCREEN 1 と SCREEN 5 がお 
すすめでしょう. 

SCREEN 1 は 文字 表示 だけの モードです. 文 宇 だけと はいっても， フォン 
トは S 由に 変えられ ますし， 文字に 色 を 付ける こと もで きます から， 工夫 次 
第で け つこう 見栄えの する 画面が 作れ ま す. 

グラフィックス 表示 をお こないた い 場合に は， ある 程度き れい な 絵が 表示 
でき， かつ 表示 も 高速な SCREEN 5 がよ いでし よ う. この モード は プロ グラ 
ミン グの しゃす さの 面から も， MSX-C による ゲーム プロ ダラ ミン グに は最 
適の 画面 モードで はない かと 思います. 本書の 後半で は， この 両 モードの 特 
徴を それぞれ 生かした プログラム を 作って みる ことにします. 



【用例】 

まず SCREEN 1 の 画面に 「SCREEN 1」 と 表示し， 何 かキ一 を 押す と 
SCREEN 0 に モード を 切り替えて 「SCREEN Oj と 表示し ます. 

ここで は テキスト 画面 (SCREEN 0 と SCREEN 1) しか 指定し ませんで し 
た 力、'， もちろん screen 関数 は グラフ ィ ック 画面 も 指定で きます. ただし その 場 
合に 気を付けて ほしいの は， プログラムの 最後で 必ず テキスト モードに 戻し 
てお く ことです. そうしな いと グラフ ィ ック j® 面の まま MSX-DOS に戾 つて 
しまい， キー入力 力 11 面に 表示され なくなって しまいます. BASIC と 違い， 
MSX-C に は プログラムが 終了しても 自動的に テキスト 画面に 炅 すよ う な 親 
切な 機 食 ではありません. 



2: 
3: 

5: 
6: 

8: 
9; 
10： 



♦include <stdio.h> 
♦include <msxclib.h> 

VOID mainC) 
< 

screen(l); SCREEN 1 を^^ 

putsC'SCREEH 1 M ); 

getchO; キーが 押される の を 待つ 

screen(0); SCREEN 0 を 指定 

puts ("SCREEN 0")； 



リスト 3.4 SCREEN. C 
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3. 1 特製 ライブラリの 全鬨数 



塞,^ 靠雙^ °! or 関数 細い. ： 

【機能】 画面の カラー を 設定し ます 

【仕お】 #include <msxclib. h> 

VOID color (fg, bg, bd) 

int fg; 前景 色 

int bg; …… 背景 色 
int bd; …… 周辺 色 

【説明】 

画面の 文字， 背景， 周辺な ど を 指定す る カラーに 変えます. この 関数 は， 
MSX BIOS の 0062 h を コールす る こと で 実現 しています. 

前景 色と は 表示す る 文字の 色の ことで， 背景 色と は 画面の 地の 色， また 周 
辺 色と は 画面の 周辺 部， 言い換えれば 額緣 のよ う な 部分の 色の こ と です. 

色の 指定 はパ レツ ト 番号 または 色 番号に よってお こない ます. 指定で きる 
値の 範囲 は 表 3.2 のとお りです. グラフ ィ ックの 画面に おいて は 前景 色 を 指 
定 しても 無意味で すが， 閧 数と して は 値 を 渡す 義務が あるので 仮に 数値の 0 
を 与えて ください. 

【用例】 

背景 色と 周辺 色 を， カラー 番号 1 から 15 までのす ベての 組み合わせ につい 
て 表示して いきます. 

プロ ダラム を 実行す ると わかり ますが， 周辺 色と 背景 色 は color 関数 を 実行 
した 瞬間に 変化し ます. しかし， テキスト 圃 面に 文字 を 表示す る 場合， 前景 
色 を 変えた だけで は 文字の 色 は 変化し ません. 文字の 色 を 変える に は， color 
関数の 後で screen 関数 を 一度 実行し なく て はなり ません， この こと を 忘れな 
いよう 注意して ください. 
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3 章 特製 ライブラリ 問 数の 説明 



P^^^l 層 










<J» レ IVI1>E* 丄、 \f 


ノヾ レツ ト 


0- 


-15 


U 


o 


o 




ノ> ？レ. ン 卜 


0~ 


-15 




o 


o 


J) レ Kunn L 


ノヾ レツ ト 


0~ 


-15 


X 


A 


0 


じ IM、 O 


/マ レツ 卜 


u- 


1 C 


A 


厶 


o 




バ レツ 卜 


0 - 


-Id 


X 


厶 


o 


«J しれ H>IZ« 丄、 o 


ノ<レ ト 


0~ 


-lo 


X 


A 


o 


cppppxj 

O し KHriLLN 。 


ノ ぐレ '、， 卜 


0- 


- 3 


X 


厶 


o 


SCREEN 7 


パ レツ ト 


0 - 


-15 


X 


厶 


〇 


SCREEN 8 


色 番号 


0- 


-255 


X 


厶 


〇 


SCREEN 10 


バ レツ ト 


0 - 


-15 


X 


厶 


〇 


SCREEN 11 


色 番号 


0 - 


-255 


X 


厶 


〇 


SCREEN 12 


色 番号 


0- 


- 255 


X 


A 


〇 



注： x は 指定しても 無意味で すが， 通常 は 0 を 設定して おいてく ださい. 
A は screen 関数に より 画而の モード を 設定した ときに 反映され ます. 
表 3*2 color 関数で 指定で きる 色 番号 



0： 


# include <stdio.h> 




♦include <msxclib.h> 


2: 




3: 


VOID madnO 




{ 


5 


int i, j, k; 


6 




7 


screen" ノ i 


8 




9 


for (i = 1; i く- 15; ++i) { 


10 


for (j = 1; j <= 15； ++j) { 


11 


color(15, j， i); Hf* 色 j, 面 辺 色 i 


12 


for (k = 0; k < 18000; ++k); 


13 




14 


； } 


15 




16 


: color(15, 1,1); カラー を 元に 戻す 


17 


： screenCP; ； 


18 





リスト 3,5 COLOR.C 
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3. 1 特製 ライブラリの 全閼数 



palett 関数 



【機能】 指定した パレット を 変更し ます （ginit 0 が 必要） 

【仕様】 #include く msxalib. h〉 

VOID palett (pi, r, g, b) 
int pi; …… パ レツ ト 番号 

int r; …… 赤の 輝度 

int g; …… 緑の 輝度 

int b; …… 靑の 輝度 

【説明】 

画面の 色 は 光の 3 原色で ある 赤， 緑， 青の 明るさの 組み合わせに よって さ 
まざ まに 変化し ます. パレット 機能 は， この 原色 それぞれの 明るさ （輝度） 
を 0〜7 の 8 段階に 指定す る ものです. 0 は その 原色が 全く 無い 状態， 7 は 一 
番 明るい 状態 を 表して います. バレット を いろいろと 変化させる と， 画面に 
描かれた 絵 を 点滅 させた り ， 瞬時に 色 を 変えて しまう こと もで き るので す. 

バ レツ ト 機能 は MSX 2/2+ の SCREEN 0〜7, 10 で 使用で きます. color 関 
数の 項で 述べた とおり， SCREEN 6 では 0〜3, それ 以外で は 0〜15 ま での パ 
レツ ト 番号 力 ^定 できます. 表 3.3 に カラ一 パレットの 電源 投入 時の 初期 状 
態 を 示します. 

【用例】 

パ レツ ト 操作に より 画面の 背景の 色 を 周期 的に 変化させます. 

まず 背景 色 を バレット コード 1( 通常 は 黒） に 設定し ます. そして， この パ 
レツ 卜に 配列 Red [14], Grn [14]， Blu [14] に 用意され た 赤， 綠， 青の 輝 
度 を 繰り返し 順番に 割り当てて いきます. 何 か キーが おされたら， バレット 
コー ド 1 の 色 を 黑に炅 して 終了 します. 
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3 車 



特製 ライブラリ 関数の 説明 





翳灣 


00 


曜 


疆 【冒 




に， 

■^3 


1』 


0 




0 


0 


0 


8 


赤 


7 


1 


1 


1 


ポ； 


0 


0 


0 


9 


明るい 赤 


7 


3 


3 


2 


緑 


1 


1 


6 


10 


暗い 黄 


6 


1 


6 


3 


m ス ぃ錄 


3 


3 


7 


11 


明るい 黄 


6 


3 


6 




暗い 青 


1 


7 




12 


暗い 緑 




1 


4 


5 


明るい 青 


2 


7 


3 


13 


マ ゼンタ 


6 


5 


2 


6 


暗い 赤 


5 


1 


1 


14 


灰 


5 


5 


5 


7 


シアン 


2 




6 


15 


白 


7 


7 


7 



表 3.3 カラー パレットの 初期化 色と パレット 設定 値 
同じような 動作 を， 暗い 赤と 明るい 赤の 間で 繰り返す と， シュ一 ティング 

ゲームに よ く みられる 火口な どの 熱源 体の 点 M« 態に なり ます. 



2 
3 

5 
6 

8 
9 

10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 



•include <stdio.h> 
#include <mszalib.h> 
# include <msxclib.h> 



int R«d[14] 
int Grn[14] 
int Blu[14] 

VOID mainO 
i 

int i, j, 
ginitO; 



{1,2,3,4,5,6,7,6,5,4,3,2,1,0}; 
{1,0,1,2,3,4,5,6,7,6,5,4,3,2}; 
{3,2,1,0,1,2,3,4,5,6,7,6,5,4}; 



1); 



P^lett 実行時に は gixiit が 必要 



RlxiiU (！ kbhitO) { なに か キー を抻 すまで ける 

for (i = 0; i < 14; { 

palettd, RedCi], Gra[i] , BluCi]); パレットの 変更 

for Ck = 0； k < im; ++k); 

} 



0)； 



最後に パ レツ 卜 を 戻して おく 



リス 卜 3*6 PALETT.C 
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3. 1 特製 ライブラリの 全 関数 

line 関数 

【機能】 グラフィック 画面 上に 直線 を 引きます （ginit () が 必要） 
【仕様】 #include <msxalib. h> 



VOID line (x 1, yl, x2， y2， cl, lg) 




… x 座標の 始点 




… y 座標の 始点 


int x2; … 


… X 座標の 終点 


int y2; … 


… y 座標の 終点 


int cl; •， 


… パ レツ ト 番号 あるいは カラ一 番号 


int lg; •* 


… ロジカル ォ ペレ一 ショ ン 



【説明】 

この line 関数 は SCREEN 5〜12 専用 （本 関数 は VDP を 直接 アクセス する 
ことにより 実現して います. したがって SCREEN 2〜4 では 使用で きませ 
ん） で， グラフ ィ ック 画面 上の 座標 (xl,yl) と 座標 （x2,y2) を 第 5 パラ 
メータ d が 示す 色の 直線で 結びます. なお 第 6 バラ メ 一タ lg は 表 3.4 のよ う 
な ロジカル オペ レー ショ ン です. 各 ロジカル オペ レー ショ ンの 機能に ついて 
は， cpym2v 関数の 項 を あわせて 参照して ください. 



睛 




麵 謹き，:: 腿:， 


0 

2 
3 


PSET 

AND 

OR 

XOR 

PRESET 


指定 色で 描画 

指定 色と 背景 色の AND を とった 色で 描画 
指定 色と 背景 色の OR を と つ た 色で 描画 
指定 色と 背景 色の XOR を とった 色で 描画 
指定 色 を 反転した 色で 描画 



表 3.4 ロジカル オペレーション 
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3 章 特製 ライブラリ 関数の 説明 



【用例】 

直線 だけで カレイ ドス コープ （万華鏡） を 描きます. 

座標 (xl.yl) は 画面 を 斜めに 移動して いきます. 座標 （x2,y2) は 画面 
の 中心に 関して それと 点 な 位置です. プログラム は， 何 か キーが 押され 
るまで この 両点を 対角線と する 4 角 形 を 描き 続けます. 直線の 色 は 0 〜： 15 ま 
で を 繰り返し， 描画の ロジカル オペレーションに 3 (XOR) を 使って いるた 
め， 画面 上で は 色が 干渉 しあって きれい な 模様に なります. 



2 
3 

5 
6 

8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 



# include <stdio.h> 
♦include <msxalib.h> 
# include <msxclib.h> 

VOID mainO 
{ 

unsigned xl, yl, x2, y2, 



ginit(); 
screen(5) ； 
color(15, 
xl = 128; 
yl = 106; 



line 実行時に は ginit が 必要 



L, 1)； 



while (IkbhitO) { キーが 押される まで 綠り 返す 

x2 - 256 - xl; 



y2 = 212 - yl; 
line(xl, yl, x2, 
line(xi, y2, x2, 
lineCxl, yl, xl, 
line(x2, yl, x2, 
if ((xl += i) == 
if ((yl += j) == 
if (++c -=16) c 



yi, c, 3)』 
y2, c, 3); 
y2, c, 3)； 
y2, c, 3)j 
6 II xl == 250) i = - i; 
2 I I yl == 210) j - -j; 



screen(0) ； 



リスト 3.7 LINE.C 
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3. 1 特製 ライブラリの 全 関数 



boxfil 関数 



【機能】 グラフィック 画面 上の 四角形 を 塗りつぶします （ginitO が 必要） 

【仕様】 #indude く msxalib. h> 

VOID boxfil (xl, yl. x2, y2, cl, lg) ； 
int x 1; …… x 座標の 始点 
int y 1; …… y 座標の 始点 
int x 2; …… x 座標の 終点 
int y2; …… y 座標の 終点 

int cl; パ レツ ト 番号 あるいは カラ— 番号 

int lg; ロジカル オペレーション 

隨 3 

この boxfil 関数 は SCREEN 5〜12 専用 （本 関数 は VDP を 直接 アクセスす 
る ことにより 実現して います. した 力 《つて SCREEN 2〜4 では 使用で きませ 
ん） で， グラフィック 画面 上の 座標 （xl,yl) と 座標 （x2，y2) を 対角と す 
る 四角形 を 第 5 パラメータ cl が 示す 色で 塗りつぶします. 第 6 パラメ一 タ lg 
は ロジカル オペレーションです • ごく 普通に 四角形 を 指定 色で 塗 る だけなら， 
lg に は 0 を 指定して ください. 各 ロジカル オペレーションの 機能に ついては， 
cpym 2 v 関数の 項 を あわせて 参照して ください， 

【用例】 

四角形 を ランダムに 描きます. 

四角形 を SCREEN 8 の 画面 上の ランダムな 位置に， ランダムな 大きさで， 
そして ランダムな 色で 描きます. こ の 動作 は 何 か キー を 押す ま で統け られま 
す， 
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3^ 特製 ライブラリ 関数の 説明 



0： 
1： 
2: 
3: 

5: 
6: 

8: 
9: 
10： 
11: 
12: 
13: 
14: 
15: 
16: 
17: 
18: 



¥xn elude <8tdio ,h> 
♦include <msxalib.h> 
tin elude <msxclib.h> 

VOID mainO 
{ 

int i; 



ginitO; 
smd() ； 
screen(8) ； 



boxfil 実行時に は ginit が 必要 



while (IkbhitO) { 

boxfil(rnd(256), md(212), 

md(256), rnd(212), rnd(256), 0); 
for (i = t; i < 8000; 

} 



リ ス ト 3.8 BOXFIL.C 



重なり合う 四角形の 群 




BOXFIL.C の 実行 画面 
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3. 1 特製 ライブラリの 全 関数 




【機能】 グラフ ィ ック パターン を 画面 上に 表示し ます （ginitO が 必要) 
【仕様】 #include <msxalib.h> 

VOID cpym2v (sr， dr, dx, dy, dp, \g) 



char *sr; RAM 上の 画像 データへの ポインタ 

int dr; 転送 方向 

int dx; …一 転送先の x 座標 
int dy; …… 転送先の y 座標 

int dp; 転送先の VRAM の ページ 番号 

int lg: ロジカル オペレーション 



【説明】 

この cpym2v 関数 は SCREEN 5〜12 専用 （本 関数 は VDP を 直接 アクセスす 
る ことにより 実現して います. したがって SCREEN 2〜4 では 使用で きませ 
ん） で， 第 1 バラ メータ sr が 示す 画像 データ を， 第 5 パラメータ dp が 示す ぺ 
ージ の， 座標 （dx'dy) の 位置に 表示し ます. 第 2 パラメ一 タ dr で 転送 方向 を 
指定す る ことによ り， 図 3.1 のように データの 上下 を 反転 させたり 左右 を 反 
転させる こと もで きます. 指定で きる ページ 番号お よび 座標の 範囲 は 表 3. 5 
のとお りです. 



0 1 2 



左上から 右下 右上から 左下 左下から 右上 一 右下から^ 上 

図 3.1 データの 転送 方向 
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3 窣 



特製 ライ ブラ リ閱 数の 説明 



： 纖擎纖 


、X 座穰變 :（ 


，麵: お,:::',::.: 


：ぺ， 番ぁ: ： 


SCREEN 5 


0〜255 


0〜191 


0〜3 


SCREEN 6 


0〜511 


0 〜： 191 


0〜3 


SCREEN 7 


0〜511 


0 〜： 191 


0〜1 


SCREEN 8 


0〜255 


0〜191 


0〜1 


SCREEN 10 


0〜255 


0 〜： 191 


0〜1 


SCREEN 11 


0〜255 


0〜191 


0〜1 


SCREEN 12 


0〜255 


0 〜： 191 


0〜1 



表 3.5 ページ 番号と 座標の 範囲 



転送す る 画像 データ は， 図 3.2 の 形式 をと ります. データの先頭に は 画像 
の X 方向お よび Y 方向の 転送 ドッ ト数を それぞれ 2 バイ ト データで 置いて お 
かなければ なりません. 

第 6 バラ メータ は ロジカル オペ レー ショ ンで， 表示す る パターンと 画面 上 
の パターンとの 問で， それぞれ 図 3,3 に 示す ような 演算 をお こない ます. 



図 3.2 cpym2v で 表示す る データの 形式 
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パイ ト数 
1 
2 
3 
4 
5 
6 
7 
8 



n + 4 



デ— タ槨成 



「上位お + | 下位 X| 

=X 方向の ドッ トの数 



:Y 方向の ドッ トの数 
パターン データ 1 
パターン データ 2 
パターン データ 3 



画像 パターン 



パターン データ n 



■ 


匪 


ffl 






E 


• 1 











s X - 

糸1 ドッ トの悄 報 は 1 バイ トの データで 表されます 



X X 

位 . 

下 上 

J I 



Y Y 

位 一せ M 

. 下 上 

一 



ー％ ^ S ...4. 

ッ ノ>」 ッ 0 

^ F や や 



3. 1 特製 ライブラリの 全 関数 



図 3.3 P ジ カル オペ レー シ ョ ンの 機能 

【用例】 

グラフ ィ ック パターン を 画面 中いた る 所に 表示し ます. 

配列 変数 Ptn [] に は 表示す る パターンが 格納され ています. 配列の 最初の 
2 バイ トは パターンの 横 方向の ドッ ト数， 次の 2 バイ トが縦 方向の ドッ ト数， 
残りが 13X19 ドッ 卜の パターン データ 本体です. 

この パターン を， ロジカル オペレーション 8 ， つま り 重ね 描きで， SCREEN 
5 の 画面 上に 表示 します. こ の 動作 は 何 か キ 一を 押す ま で 線け られ ます. 



8:TPSET 9:TAND 3:X0R(11:TX0R) 12:TPRESET 



A の パターン を B の 背 
景に 転送 するとき ロジ 
カル オペ レー ショ ン指 
不 によって 下図の よう 
に 表示され る 

OrPSET 1:AND 2:OR(10:TOR) 4:PRESET 
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3 章 特製 ライブラリ 閱 数の 説明 





: # include <£ 


itdio.h> 








: # include <msxalib.h> 








: # include <n 


isxdib.h> 






«-> 


: char Ptn [4+13*19] = { 13, 0, 19, 0 


j<>t 、 j 


C 

O 






4, 4, 4, 4, 


4, 4> 4, 4, 


A A A /J\ ^ 一 A3 


\> 




'き, 0. 


4, 4, 4, 4, 


4, 4, 4,15， 


AAA 

4, 9» 9f 






F > ^ > 


4, 4, 4, 4, 


4, 4, 4,15, 


AAA 
4, V, V, 


p 

o 




汇 0> 




4, 4, 4,15, 












4, 4, 4,15, 


y y 






0) に 


く 4^ バ A, 


4, 4, 4, 4, 


AAA 


丄 丄 




0, 0, 


4, 4, 4, 4, 


4, 4, 4,15, 


A. A (k 


丄 ム 




4, 4, 


4, 4, 4, 4, 


4, 4, 4, 4, 


AAA 








0,11,11, 8, 


8, 8,11,11, 


0 0 0 


14 




t\ A, 


4, 4,1 に 11, 


11,11,11, 4, 




丄 " 




4, 4, 


4, 4, 4, 4, 


4, 4, 4, 4, 


AAA 


丄 リ 




4, 4, 


4, 4, 4, 4,11, 4, 4, 4, 


AAA 


丄 1 




11,11, 


4, 4, 4, 4, 


4, 4, 4, 4, 


4,11,11, 


XO 




11,11, 


4,11, 4,11,11,11, 4,11, 


4,11,11, 


i9 








4, 4, 4, 4, 


4, 9, 9, 






に に 


4, 4, 4, 4, 


4, 4, 4, 4, 


4, 9 9 9, 


り 4 




0, 8, 


8, 0,11,11, 


0,11,11, t> 


8, 8, 0, 


22 




8, 8, 


8, 8, 8, 8, 


0, 8, 8, 8, 


8, 8, 8, 


ZO 




8, 8, 


8, 8, 8, 8, 


0 S 8, 8, 8, 


o o o \ . 


24 












4 &リ 


VOID mainO 






26 












97 

ム 1 




int i; 


























cpym2v 実行時に は ginit が 必要 






srndO; 






OH 

ol 




colord 


5, 1, 1)； 






QO 
OZ 




screen(5) ； 






oo 

3o 
















while (！ kbhitO) { 
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cpym2v(Ptn J jJ, 






oo 






rnd(240), 


rnd(195), 0, 


8); 8:TPSET 


37 




for (i = 0; i く ++i); 


38: 












39: 




screen(0) ； 






40: 













リスト 3.9 CPYM2V.C 
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3. 1 特製 ライブラリの 全 関数 



CPW2V 関数 



【機能】 グラフィック バタ一 ンを VRAM 上て せ 動し ます 

【仕 fe】 ffinclude く msxalib. h> 

VOID cpyv2 v (x 1, y 1, x 2， y2, sp, dx， dy, dp, lg) 

int x 1; 転送 元の x 座標の 始点 

int y 1; 転送 元の y 座標の 始点 

int x 2; …… 転送 元の x 座標の 終点 
int y2; …… 転送 元の y 座標の 終点 
int sp; …… 転送 元の ページ 番号 
int dx; …… 転送先の x 座標の 始点 
int dy; …… 転送先の y 座標の 始点 
int dp; …… 転送先の ページ 番号 
int lg; ロジカ クレオ ペレ ーシ ヨン 

【説明】 

cpyv2v 閼数は SCREEN 5〜12 専用 （本 関数 は VDP を 直接 アクセス する こ 
とに より 実現して います. したがって SCREEN 2〜4 では 使用で きません） 
で， 第 5 バラ メータ sp が 示す VRAM の ページ 上の 座標 （xl，yl) から （x2， 
y2) の 範囲の 両像 を， 第 8 パラメータ dp が 示す ページ 上の 座標 （dx，dy) へ 
転送し ます. なお， 第 9 パラメータ lg は ロジカル オペレーションで， cpym2v 
関数の ものと 同じです. 

【用例】 

キャラクタ が 帽子の 中に 隠れて いきま す. 

まず パターン を襄 ページ （ページ 1) に 転送して から， この パターン を表ぺ 
ージ （ページ 0) にも 転送し ます. そして， ページ 1 から 帽子の 部分 だけ をぺ 
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3 窣 特製 ライブラリ 関数の 説明 



ージ 0 に表不 されて いる キャラクタの 上に， 従来の 位置よりも 1 ドット 下げ 
て 転送し ます. これ を 2 ドッ ト 下げ， 3 ドッ ト 下げ， 最終的に は 8 ドッ ト まで 
下げ， 帽子と 靴 だけの 姿に なって しまう のです. 

お気付き になり ましたで しょ うか？ ここでの ポ イン トは 転送す る 帽子の 
パターンの 最上 ラインに あります. 実は， この ライン はすべ て o で 構成され 
ています • この ライン は， 転送され る ごとに 生じる 画像 ズレ による 余分な 部 
分 を 消去して いるので す. 言い換えれば， この ライン は 画面 上の ゴミを 拭き 
取る 作用 をして いる わけです. 些細な ことであります が， 髙速 処理が 求めら 
れる 場合に は 有効な 一手 段で あり， 覚えて おいて 損 はない と 思います. 



» include <stdio.h> 
# include <msxalib.h> 
♦include <msxclib.h> 



0, 0, 
も、 0, 
0, 0, 

に に 
0, 0, 
0, 0, 
0, 0, 

に i\ 

4, 4, 



VOID mainO 
{ 



,11,11, 
,11,11, 
, 0, 0, 
, 0> 0, 
, 8, 0, 
' 8, 8, 
( 8, 8 }; 



12 3 



6 7 8 9 0 1 



4 5 6 7 



-01234567 

-22222222 



2 

5 



04444444404444444888 

04555545414444144088 

204444444411444444183 

» 1 1 1 

004444444481444144183 

3 0 4 4 4 444448141411*4000 

1 111 

{044444444814441441^88 

I 一 1, ： ,パ ：1> : 

04444444411444444*188 

S 1>1, 1:1 

^0 4444444414444144088 

^-04444444404444444888 

P000000004004 4 1 10 0 0 8 8 

r 11 

a 

h 



3. 1 特製 ライブラリの 全 関数 



int 



ginitO; cpyv 2 v 実行時に は ginit が 必要 

color(15, 1, 1); 
8creen(5) ； 

cpym2v(Ptn, 0, 10, 10, 1, 0); パタ-ン を 

裏 ページに 転送 

while (！ kbhitO) { 

for (j = 0; j < 30000； 

cpyv2v(10, 10, 22, 29, 1, 100, 100, 0, 0)； 

for (j = 0; j < 20000; 

for (i = 101; i <= 108; ++i) { 

cpyv2v(10, 10, 22, 18, 1, 100, i, j», 0); 

for (j = 0; j < 2000; ++j); 

} 



screen(0) ； 



リス 卜 3,10 CPYV2V.C 



帽子が する する 降りて ゆく 




CPYV2V.C の 実行 画面 
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3 章 特製 ライブラリ 関数の 説明 




【機能】 スプ ライト を 初期化し サイズ を 決定し ます 
【仕様】 ？ include <msxclib. h> 
VOID inispr (sz) 

int sz; …… ス プライ ト サイズ 番号 

【説明】 

inispr() 関数 は， ス ブライト 表示 を 初期化 するとと もに， スプ ライトの サ 
ィズを 定義し ます. ス プライ ト サイズ は 図 3.4 のとお り 4 種類 用意され てい 
ます. 



【用例】 

putspr 閧 数の 項 を 参照して く だ さ い. 
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HI3.4 スプ ライトの サイズの 設定 
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3. 1 特製 ライブラリの 全 関数 




【機能】 ス ブライト パターン を 定義し ます 



【仕様】 #include く msxclib. h> 



VOID sprite (no, dt) 

int no; '• •' ス プライ ト バタ一 ン 番号 

char *dt; -…' ス プライ ト パターン データへの ポインタ 



【脱 明】 

sprite 関数 は， 第 1 バラ メータ no で 指定され る 番号の ス プライ トに， 第 2 バ 
ラ メータ dt で 示される ス プライ ト パターン データ を 定義し ます， ス プライ ト 
パターン は ， 8 X 8 サイズの とき は 最大 256 個まで， 16 X 16 サイ ズの とき は最 
大 64 個 ま で 登録 する ことができます. 

まず， 8X8 サイズの ス プライ ト パターンの 構造に ついて， 簡単に 述べて い 
きます. 8X8 サイズの スプ ライトで は， 図 3.5 のように， 画面に 表示す るド 
ッ トを 1, 透明の まま にしておく ドッ トを 0 と 考える と， 横 8 ドッ トは 8 桁の 




wipnxi — 
― Hum — 

I ま 1 隱翻 I — 01111110 

y I m 1 1— ooiooioo 

— 01111110 

一 にぶ に, ■ — 11111111 

^11 I 刚 I 1001 1001 

01100110 



\m I 國 



各行 は 8 桁の 2 進数 
として 表現で きる 



図 3,5 8X8 ドット サイズの スプ ライト パターン デーづ 
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3 举 特製 ライブラリ 照 数の 説明 

2 進数， つまり char 型の データと して 表記す る ことができます， これ を 縦 8 ド 
ッ ト ぶん 橾り返 すと， char 型の データ 8 個で 8X8 ドッ トのス プライ ト バタ 
ーン データが 表されます. この 8X8 サイズの ス プライ ト パターン は 最大 256 
個まで 登録す る こと がで き， それぞれ 0〜255 の スプラ ィ ト パターン 番号 を 持 
つてい ます. 

16X16 卞ッ ト サイズの ス プライ トバ ターン は， 8X8 ドッ トのス ブライ 4 枚 
を 図 3,6 のように 並べた ものです. した 力 < つて， 8X8 ドットの ス プライ トバ 
ターン データ 8 個 を 1,2,3,4 と 順々 に 並べた 32 個の char 型 データで， 16 x 
16 サイズの ス プライ ト パターンが 定義され ます. 16X16 サイズの ス プライ ト 
パターン は 最大 64 個 ま で 登録す る こと がで き， それぞれ 0〜255 の 下位 2 ビ 
ッ ト を 無視した， つま り 0,4,8, …… のス プライ ト パターン 番号で 指定され ま 
す. 

【用例】 

putspr 関数の 項 を 参照して く ださい. 



パターン 1 パターン 3 




図 3.6 16X16 ドッ ト サイズの ス プライ ト パターン 構成 
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3. 1 特製 ライブラリの 全閱数 



.^ ' ノ . ■■ - ，： - ..... ' • ■ . 

マ DUtspr 関数 



【機能】 スプ ライト を 画面に 表示し ます 

【仕 %】 お nclude く msxclib. h〉 

VOID putspr (no, x, y, cl， pt) 

int no; …… ス プライ ト面 番号 （0〜31) 

int x; …… x 座標 (0〜255) 

int y; …… y 座標 （-16〜190 または- 16〜210) 

int cl; …… カラ一 番号 あるいは パ レツ ト 番号 

int pt; …… ス プライ ト バタ一 ン 番号 （0〜255) 

【説明】 

putspr 関数 は， 第 1 バラ メータ no で 指定され るス プライ ト 面の 座標 （x,y) 
に， 第 4 バラ メータ cl で 指定され る 色で， 第 5 パラメータ pt で 指定され る 番号 
のスプ ライト パターン を 表示し ます. ただし， モード 2 のス ブライト 
(SCREEN 4〜8) では， cl で 指定した 色 は 無視され ます. モード 2 のス ブラ 
ィ トは， 次に 紹介す る colspr 関数 を 使って 色 を 設定して ください. 

MSX のス プライ ト 表示に おける y 座標 標） は- 1 から 始まる 系列 を 持 
つてい ます. つまり， 驚ぐな かれ 通常 y 座標 0 である 画面 最上 段 は， なんと ス 
プライ ト において は y 座標- 1 という 世に も 奇怪な 現象と なって いるので す. 

ス プライ ト モー ド 1 の 場合 は y 座標 を 208， ス プライ ト モード 2 の 場合 は y 
座標 を 216 に 指定す る ことで， その ス プライ ト面 以降の ス プライ ト はまった 
く 表示され なく なります. 

なお， この putspr 関数で は， x 座標に マイナスの 値 を 与えて ス プライ トを画 
面の 左端へ 消し 去る こと はでき ません. それ を 実現す るに は， かなり 面倒な 
処理が 必要で， スプ ライト 表示の 速度に も 影響が 出て くるた め， 機能 を 割愛 
させても らいました. 
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3 車 特製 ライブラリ 閲 数の 説明 



【用例】 

ポールが 放物線 を 描きながら 画面 上で は ずみ ます. 

まず inispr 関数 を 実行して， スプ ライト を 16X16 サイズに 設定し ます. 次 
に sprite 関数で， 配列 Sprpt [] に 用意した データ を 0 番 のスプ ライト バタ一 
ン として 与えます， 

putspr (0,x,y，7，0) は， スプ ライト 面 0 の 座標 （x,y) に， カラー 7 で， 
0 番のス プライ トを 表示し ます. putspr (l,240-x,y,8,0) は， ス プライ ト面 
1 の 座標 （240-x,y) に， カラー 8 で， 0 番のス ブライト を 表示し ます. 

ここで は SCREEN 2 を 使って いるた め， ス ブライ トの モード は 1 となり， 
putspr 関数の 第 4 バラ メータで ス プライ 卜の 色が 指定で きます. モード 2 の 
ス プライ トを 利用す る 場合の 色の 指定 方法 は， colspr 関数の 項 を 参照して く 
ださい， 



9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
2S 
26 
27 
28 





char Ptspr [32] 


= { 






ポールの ス プライ トバ ターン 


5: 


0x07, 0xlf, 


0x37, 


0x7f , 


0x6f, 


0xdf „ 0xdf, 0xdf , 


6: 


Mt» 0xff, 


0xff , 




0x7f, 


0x3f, 0xlf, 0x07, 


7: 


0xe0, 0xf8, 


0xfc, 


toe, 


0xfe, 


0xff, 0xff, tof , 


8: 


0xfl, 0xff, 


0xff, 


0xfe, 


0xfe, 


0xfc, 0xf8, 0xe0 >; 



# include <stdio.h> 
# include <msxalib.h> 
霧 include <msxdib.h> 



VOID mainO 
{ 

int x, y, dx, dy, 



, 1, 1)； 



inispr(2); 16x16 ドッ ト通 * サイズ を 指定 

sprite(0; Ptspr) ； ス ブライト パターンの S 定 

for Cx=0, y«4, dx=3, dy=0; y<l7S | I dy; ++dy) { 

putspr(0, x, y, 7, 0); ボール を 第0 面に 表示 

putsprCl, 240-x, y, 8, 0); ポール を *1 而に 表示 

if «x +- dx) == 240 I I x == 0) dx = -dx; 
if (Cy += dy) « 175) dy = -dy; 
for (i = 0; i < 1000; ++i); 

} 



リスト 3.11 PUTSPR.C 
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3. 1 特製 ライブラリの 全 関数 



薄，； きな，， 經 




气き 稱. 雜, 
《纖 



: 灣 
. ち 魔 



【機能】 ス ブライトの 1 ライン ごとの 色 を 指定し ます 



【仕様】 include <msxclib. h> 



VOID colspr (no， dt) 

int no; …… ス プライ ト面 番号 

char *dt; …… ス プライ トカラ 一データへの ポインタ 



【鋭 明】 

この 関数 は， モ一 ド 2 (SCREEN 4〜8) のス プライ ト を 使用す る 場合の み 
意味 を 持ちます. モー ド 2 のス プライ トは， 1 ライン ごとに 異なる 色 を 指定で 
きます. これで モード 1 のス ブライ トの 欠点の 1 つで ある 乏しい 色彩 表現が 
多少な りと も 克服 される わけ です. 

色の 指定に は 8 x 8 サイズの 場合 は 8 個の カラ一 データ， 16 X 16 サイズの 
場合 は 16 個の カラ一 データが 必要と なります， カラ 一データの 構造 は 図 3.7 



4 3 2 1 0 (ビッ ト） 



*dt 



EC 



EC 



EC 



CC 



CCI 



CC 



IC 



IC 



IC 



0 



ス プライ ト 



ス ブライ ト 
ス "ブラ^ト 



ECI_CCI_ ICI_ Of ス ブライト も 




EC …一 32 ビッ ト 左シフ ト 表示 （1: 行う/ 0: 行わない） 
CC - -，… 優先順位 （1: あり /2: なし〉 
IC …… 衝突 検出 （h する Z0: しない） 



図 3.7 ス プライ トカラ 一 テーブルの 構造 
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3 章 特製 ライブラリ 問 数の 説明 





黒 


ず 

'も. 


暗い 綠 


、'、'や ■ 


肌色 


12； 

'■ にノ ハ 




tm 


暗い 青 


m 


暗い 水色 


ひ 


青 




色 




暗い 赤 




喑ぃ风 色 


'•: ひ 

n 


赤 




黄色 


i 


暗い 紫 


if 


灰色 


it 


紫 


'm 


白 



表 3.6 SCREEN 8 のスプ ライトの 色 

に 示す とおりです. ス プライ トの色 は 基本的に はパ レツ ト 番号で 指定し ます. 
た だ し SCREEN 8 では 表 3 ， 6 の 16 色に 固定され てい ま す. 

ここで 奥義 「ス プライ ト 2 枚 重ね」 を 披露し ましょう. モード 2 のス ブラ 
ィ ト では， 2 枚の ス プライ トバ ターン を 使う ことで， 横 1 ライ ン にっき 3 色 ま 
で 出す ことができる のです. 

どう して ス プライ ト 2 枚で 3 つの 色が 出せる のでし よ うか. 通常 はス ブラ 
ィ トが 重なると， 手前に ある ス プライ 卜が 後ろの ス プライ トを 隠して しまい 
ます. ところ カヽ 後ろの スプ ライトの カラー テーブルの CC ビット を、、 1ク にし 
てお く と， その ラインの 重なった 部分 は， 両者の カラ一 コードの OR (論理和） 
をと つた カラー コードで 表示され るので す. ですから， スプ ライト を 2 枚 使 
うだけ で 図 3.8 のように， （1) 手前の スプ ライトの 色， （2) 後ろの ス プライ 
トの 色， （3) 重なった 部分の 色， という 3 色が 出せる わけです. 



1 枚 目の スブ ライト 2 枚 目の スブ ライト 表示され る パターン 
' ' " (CC ビッ ト =1) 





黒色 



ス ブライト 色香 号 1 (黒色） 灰色 2 つの 色の 重なる 部分 
ス ブライ ト色 番号 14 (灰色） 14 or 1 = 15 (白色） 



図 3.8 ス プライ ト 2 枚 重ね 
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3. 1 特製 ライブラリの 全 関数 



実際に は 重ねる ス プライ トは 何枚で も かまいません， その 場合 一番手 前の 

ス プライ ト だけ CC ビッ トを ゃ0ク にして おいて， 残りの ス ブライ トは CC ビッ 

トを すべて や r に 設定し ます， ただし， あまりた くさん 使う と 今度 はス ブラ 
ィ トの 表示に 手間が かかり ますし， 「1 ライン 上に 8 枚まで」 という ス プライ 

トの 表示 枚数 制限に も ひっかかり やすくなります から， やはり 実用的に は 2 

枚 重ねまで が 限度で しょ う. 

【用例】 

画面 上 を 蝶が 舞います. 

この プログラム では ス プライ ト 2 枚 重ね を 使って います. ス プライ ト バタ 
—ン は， 配列 PtsprO [] に 0 番のス ブライト， 配列 Ptsprl [] に 1 番 のスプ 
ライ 卜の データ を 入れて います. ス ブライ トカラ 一は， 配列 ClsprO[] が 0 番 
のス プライ ト， 配列 Clsprl [] が 1 番のス プライ ト 用です. Clsprl [] のス 
プライ トカラ 一 データ はすべ て， CC ビッ ト を 气" にした 場合の 加算 値 64 を 
本来の パレット 番号に 加えた 値に なって います. これが， スプ ライト 2 枚 重 
ねの 秘訣で あり ます. 

move 関数 はス プライ トを 移動させます. 蝶が 宙を 舞う がごと く みせる ため 
に， x 座標 そして y 座標 それぞれ を- 1 〜十 1 の ランダムな ごくわず かな 移動の 
連統で 表して います. そして， x 座標 は 0〜240 の 範囲で， y 座標 は- 1 一 195 の 
範囲て 嘴 動 させて います. 



0: # include <stdio.h> 
1: # include <msxalib.h> 

2: # include <msxclib.h> 

3: 

4: char Ptspr0 [32] 
5: 0x04, 0x72, 

6: 0x72, 0xla, 
7: 0x40, 0x9 c, 

8: 0x9c, 0xb0, 

9: 

10: char Ptsprl [32] = { 2 枚 目の ス ブライト パターン 

11: 0x00, 0x00, 0x20, Ml, 0x43, 0x01, 0x01, 0x41, 



= { 1 枚 目の ス ブライ ト パターン 

0xfa, 0xfc, 0xie, 0xfe, 0xfe, 0xfe, 

0x36， 0x76, 0x7e, 0x7c, 0xd8, (Kx80, 

0xbe, 0x7e, 0xfe, 0xfe, 0xfe, {Jxfe, 

0xd8, 0xdc, 0xfc, 0x7c, 0x36, 0x02 
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3 章 特製 ライブラリ 関数の 説明 



12: 
13: 
14: 
15: 
16: 
17: 
18: 
19: 
20: 
21: 
22: 
23: 
24: 
25: 
26: 
27: 
28: 
29: 
30: 
31: 
32; 
33: 
34: 
35: 
36: 
37: 
38: 
39: 
40: 
41: 
42: 
43: 
44: 
45: 
46: 
47: 
48: 
49: 
50: 
51: 
52: 
53: 



0x0d, 0x05, 0x09, 0x28, 0x00 y 0x10, 0x00, 0x00, 
Mt, 0x00, 0x08, M0, 0x84, 0x00, 0x00, 0x04, 
0x60， 0x40, 0x20, 0x28, 0x00, 0x10, 0x0 j), 0x00 }; 



char Clspr0[16] 



1 枚 目の ス ブライ トの色 



char Clsprl [16] = { 2 枚 目の色 （すべて +64〉 

1 2+64 , 1 2+64 , 1 2+64 ,12+64, 12+64 , 6+64, 6+64,12+64, 
12+64, 12+64, 12+6442+64,12+64, 12+64, 12+64, 12+64}; 

int Xpos [12] , Ypos [12] ； 

VOID moveO 
{ 

int i, x, v; 

for (i = 0; i < 12; ++i) { 
x = Xpos [i] + rnd(3) - 1; 
y = Ypos[i] + rnd(3) - 1; 
if (x < 0) x = 0; 
if (x > 240) x = 240; 
if (y < -l) y 
if (y > 195) y 
putspr(i * 2, j 
putspr(i * 2 + 
Xpos[i] = x; 
Ypos[i] = y; 



195; 

y, 0> 0); 

， x, y, t t 4); 



VOID mainO 
{ 

int i; 

srndO ； 
ginitO ； 

color(15, 10, 10); 
pa.lett(13, 4, 7, 5); 

screen(5) ； SCREEN 5 では ス ブライ 卜の モー ドは 2 

ii\ispr(2) ； 
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3. 1 特製 ライブラリの 全 関数 



54: sprite(0, PtBpr0); 

55: sprite", Ptsprl); 
56: 

57: for (i = 0; i < 12; ++i) { 

58: Xpos[i] = rnd(120) + 60; 

59: Ypos[i] = rnd(120) + 38; 

60: colsprd * 2, Clspr0) ； ••••• 通常 表示 

61： colsprd * 2 + 1, Clsprl); Clsprl の データに 

62: } 64 が 足されて いる 

63: ので、 重ね 表示 

64: while (！ kbhitO) { 
65: move リ） 

66: for (i = 0; i < 400; ++i〉； 

67: } 

68: 

69: color(15, 1, 1); 

70: palett(13, 6, 2, 5); 

71: screened;; 
72: } 



リスト 3.12 COLSPR.C 
スプ ライト 2 枚 重ねの 極彩色 蝶 




COLSPR.C の 実行 画面 
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3 瘃 特製 ライブラリ 関数の 説明 



【機能】 VRAM へ 1 バイ トの データ を 書き込みます （gi n i t () が 必要） 

【仕様】 #indude <msxalib. h> 

VOID vpoke (ad, dt) 

unsigned ad; VRAM ァ ドレス 

char dt; …… 書き込む データ 

【説明】 

vpoke 関数 は， 第 1 バラ メータ ad の 指し示す VRAM アドレスに， 第 2 バラ 
メータの 指し示す 1 バイト （ C h ar 型） の データ dt を 書き込みます. 

画面に データ を 表示す る 場合に 使える の は もちろんです 力、 *， MSX では 実際 
に 画面に 表示され る データ 以外に も， フォント パターン や カラ —テーブルが 
VRAM 上に 存在して います. この vpoke 関数 を はじめ， これから 紹介す る 
vpeekM 数， ldirmv 関数， Idirvm 関数 は， こういった VRAM 上の データ を 協- 
作す る 場合に も 利用で きます. 

【用例】 

渦 を卷く ように 面面の 外から 内に 文字 を 表示し 消去し ます， 

プログラムの 最初に 定義して いる fill 関数 は， SCREEN 1 の 画面 上に パラ 
メータ ch で 示される キャラクタ コード を 次々 と軎き 込んで いきます. なお， 

SCREEN 1 の 画面の VRAM ァ ドレス は， メイ ン メモリの 0xf3bd 番地に 記録 
されて います. 

初の for 文の 中に 4 組の for 文が 存在し ますが， それぞれ 左から 右へ， 上 か 
ら下 へ， 右から 左へ， 下から 上へ と 文字 を 書き 込みます 




I 
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3, 1 特製 ライブラリの 全 関数 



8: 
9: 
10: 
11: 
12: 
13: 
14: 
15: 
16: 
17: 
18; 
19: 
20: 
21: 
22: 
23: 
24: 
25: 
26: 
27: 
28: 
29: 
30: 
31: 
32: 
33: 
34: 
35: 
36: 
37: 
38: 
39: 
40; 
41: 
42: 
43; 
44: 
45: 
46: 
47: 
48: 



霧 include <etdio .h> 
# include <maxalib.h> 
f include <B8xclib.h> 

#defirte T32NAM *((int *)0xf3bd) 

VOID fill(ch) 
char ch; 

int i, j , k; 

int ad = T32NAM - 1; 

int x - 32; 

23; 



SCREEN 1 の 先 W ァ ドレス 



int y - 

for (i -' 
for 



} 

for 



<* 11; ++i) { 



(j » ^ j < 
vpoke(++ad, 
for (k =» 0; 



ch); 



1000； 



} 

—y; 
for 



} 

一一 x; 
for 

> 



(j -0； j 

vpokeCad 
for (k = HI 



(j = 0； j < 
vpoke(~ad, 
for (k 霹 0; 



(j = 0； j < 
vpokeCad -- 
for (k > 0; 



y; 叫〉 { '…い' 

32, ch); 

k < 1000； ++k); 



x; ++j) { ―… 
ch); 

k < 1000; 



y; ++j> { ……- 

32, ch); 

k < \m\ ++k); 



左から 右に 向かって 表示 



上から 下に 向かって 表示 



右から 左に 向かって 表示 



下から 上に 向かって 表示 



> 

VOID mainO 
int i; 

ginitO; vpol ^夷 行 時には ginit が 必要 

color(15, 0, U); 
8creen(l) ； 

fill('? り； 画面 を", で 埋める 

fill(' 0; Siffi を， ，で 埋める （つまり 文 宇 を 消す） 

screen(0) ； 

> 



リスト VPOKE.C 



65 



3 章 特製 ライブラリ 関数の 説明 



ク晨 ^ 



vpeek 関数 



【機能】 VRAM から 1 バイトの データ を 読み出します （g init() が 必要） 



【仕様】 include <msxalib. h> 



char vpeek (ad) 

unsigned ad; VRAM ァ ドレス 



【説明】 

vpeek () 関数 は， パラメータ ad の 指し示す VRAM アドレスの 内容 1 バイ 
ト （char 型） の データ を 返します. 

【用例】 

テキスト 画面の 各ラ ィ ン を 左右 反転させます. 

ま ず， 現在 使用 している テキスト 画面の VRAM ァ ドレスと 1 行の 長 さ を 調 
ベて， それぞれ adtop, len という 変数に 記憶し ます. 続いて， 画面の 各 ライン 
について 文字の 並び 方 を 左右 ひつく り 返します， 

現在の 画面 モ一 ドは メインメモリ 上の Oxfcaf 番地に 記録され ています， 現 
在の 1 行中の 文字 数 は 同 じ く 0xf3b0 番地に 記録され てい ま す. SCREEN 0 
の 画面 先頭 ァ ド レス は 0xf3b3 番地， SCREEN 1 の 画面 先頭 ァ ド レス は o x f3 
bd 番地に あります. 



0： # include <stdio.h> 
1： # include <msxalib.h> 

2: 

3： #define SCRMOD *((char *)0xfcaf) スクリーンモード 
4: #define LINLEN *((char *)0xf3b0) 1 行の： R さ 

S: #define TXTNAM *((uiiBigned *)0xf3b3) SCREEHO の 先頭 
6: #define T32NAM *((imsigned *)0xf3bd) -…' SCREEK1 の 先頭 
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3. 1 特製 ライブラリの 全膦数 



7: 
8: 
9: 
10： 
11: 
12: 
13: 
14: 
15: 
16: 
17: 
18: 
19: 
20: 
21: 
22: 
23: 
24: 
25: 
26: 
27: 
28: 
29: 
30: 
31: 
32: 



VOID mainO 
{ 

unsigned i, al, a2， adtop, len; 
char chl, ch2; 

ginitO; vpeek 笑 行 時には ginit が 必要 

if (SCRMOD == 0) { SCREEN 0 の 場合 

adtop = TXTNAM; 

len = (LINLEN > 40)? 80: 40; LINLENMO なら 

} 80 宇 モード 

else { SCREEN 1 の 場合 

adtop = T32KAM; 

len = 32; 

} 

for (i = 0; i < 24; { 

al = adtop + len * i; 行の 左端の ァ ドレス 

a2 = al + len - 1; 行の 右 镟のァ ドレス 

do { 

chl = vpeek(al); 
ch2 = vpeek(a2); 
vpoke(al, ch2); 
vpoke(a2, chl); 
} while (++al < — a2); 



} 



リス 卜 3.14 VPEEK.C 



《MSX-C 豆 知識》 #define マク 口 について 

「#define j は 文字列の 置 き 換え をお こなう 置換 マ ク 口 です. たとえ ば， 「0 
xf3bd 番地に 記録され ている unsigned 型の データ」 は， キャス ト 演算子と ポィ 
ンタ 演算子 を 使って， 「* ((unsigned *) 0xf3bd)」 と 表します が， これ を 
そのまま プログラムの 中に 書く とゴ チヤ ゴ チヤして わかりにく くな つてし ま 
います. そこて ifdefine マクロ を 使って， これ を r T 32 NAM」 と 定義して お 
く と， 以後 ソース プログラムに 現れる r T32NAM」 は， すべて その 文字列 
に 置き換えられる ことにな り， プログラムが 見やす く なります. 
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3 窣 特製 ライブラリ 関数の 説明 



― Idirvm 関数 ― 

【機能】 VRAM へ一 度に 複数の データ を 書き込みます （ ginit () が 必要） 

【仕様】 include く msxalib.h〉 

VOID ldirvm (ds， sr, In) 
unsigned ds; • … 転送先の VRAM ァ ドレス 
char *sr; …… 転送 元 データへの ポインタ 
unsigned In; …… 転送 データ 長 

【鋭 明】 

第 1 バラ メータ ds が 示す VRAM ァ ドレスへ， 第 2 パラメータ sr が 示す ァ ド 
レスの メインメモリから， 第 3 バラ メータ In が 示す バイ ト数 だけ データ を 転 
送し ます. 

【用例】 

フォント パターン を 書き換えます. まず 画面に 、、 0 ク から 勺,， までの 数字 
が 表示され ます. ここで 何 か キー を 押す と， その フォント 力 < 変更され ます. 
も う 一度 何 か キー を 押す と プログラム は 終了し ます. 

SCREEN 1 の フォント パターン は， 0xf3cl 番地に 記録され ている VRAM 
アドレスから， 1 文字に つき 8 バイ トを 使って 格納され ています. 

2 次元 配列 data [10] [8] は， 10 侗 ぶんの フォント データの 定義です. こ 
の データ を 数字 や 0ク の フォント パターンの アドレスに 転送す る ことで 、タ 
から 、、9" の 10 個の 数字の フォント パターン を 書き換える ことができます. 

なお， screen 関数 を 実行す ると， フォント パターン は 元に 戻ります 
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3. 1 特製 ライブラリの 全 関数 



2: 
3: 

5: 
6: 

8: 
9: 
10： 
11: 
12: 
13: 
14: 
15: 
16: 
17: 
18: 
19: 
20: 
21: 
22: 
23: 
24: 
25: 
26: 
27: 
28: 
29: 



» include <stdio.h> 
# include <msxalib.h> 
•include <msxclib.h> 

idefine T32CGP (♦(unsigned *)0xf3cl) 



フォン I 















のァ ドレス 


char < 


iata[10] [8 


] = < 












{ 


0x00,0x00 


>0x00 


,0xf0,0x90 > 


0X90, 


0xf0, 


0x00 




{ 


0x60,0x20 


,0x20 


,0x20,9x20, 


0x20, 


0x20, 




\ 

J > 




0x18,0x08 




p V 丄 W ^ ffJLK^J^ , 










{ 


0xf8,0x88 


,0x08 


,0xf8,(Hx08, 


0x88, 


0xf8, 


0x00 




{ 


0x90,0x90 


,0x90 


,0x90, 0xf8, 


0x10, 


0x10, 


0x00 


}: 


{ 


0xf 0,0x80 


JxS0 


,0x18,0x08, 


0X08, 


0xf8, 


0x00 




{ 


0x80 , 0x80 


JxQt 


,0xf8,0x88, 


0x88, 


0xf8, 


0x00 


}: 




0xf8,0x88 


,0x10 


,0x10,0x20, 


0x20, 


0x20 y 


0x00 






0xf8»0x88 


,0x88 




0x88, 


0xf8, 


0x00 


}[ 


{ 


0xf8,0x88 


,0x88 




0x08, 


0x08, 


0x00 




VOID mainO 














int i; 















ginitO; 



ldirvm 実行時に は ginit が 必要 



puts("¥f 0123456789¥n") ； 
getchO; 

ldirvm(T32CGP + f 0 } * 8, data, 80); 

getchO ； 

screen(0); 



'0' から 
10 文字の 
フォント を 
変更 



リスト 3.15 LDIRVM. C 



《MSX_C 豆 知識》 フォント パターンの ァ ドレス 

フォント パターンが 存在す る VRAM 上の ァ ド レス は， SCREEN 0 
SCREEN 1 で， それぞれ 次の ワーク エリアに 記録され ています. 

SCREEN 0 ： 0xf3b7 
SCREEN 1 ： 0xf3cl 
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3 章 特製 ライブラリ 閱 数の 説明 



糊贿 関数 



【機能】 VRAM から一 度に 複数の データ を 読み出します （g init() が 必要) 
【仕様】 #include <msxalib. h> 

VOID ldirmv (ds, sr, In) 



【説明】 

第 1 パラメータ sr が 示す メ イン メモリへ， 第 2 パラメ一 タ sr が 示す VRAM 
アドレスから， 第 3 パラメータ In が 示す バイト 数 だけ データ を 転送 f + す， 



フォント パターン 、、に を 拡大 表示し ます. 

まず フォ ント パターン、、 A タを ldirmv 関数に よって 読み取ります， 読み込ん 
だ フォント パターン は ch ar 型の データ 丄 つが 横 8 ドッ トの パターン 構成と 
なって います. 

そして， ビット シフト 演算子 を 用いながら， Wt7 が、、 0 "のとき はス ベー 
ス， 、、卩 の 時 は を 画面 上に 描いて いきます. これ を 縦 8 ライン ぶん 繰り 
返す ことで， 画面 上に フォント バター ン 、、 A " を 拡大して 表示し ます. 



char *ds; 
unsigned sr; 
unsigned In; 



転送先 デー タ 領域への ポインタ 
転送 元の VRAM ァ ドレス 
転送 データ 長 



【用例】 
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3. 1 特製 ライブラリの 全 関数 



0: # include <stdio.h> 
1: # include <mBxalib.h> 
2: # include <msxclib.h> 

3: 

4: #define T32CGP *((int *)0xf3cl) 

5: 

6: VOID mainO 

7: { 

8 : char data [8] ； 
9: int i, j; 
10： 

11: ginitO; ldirmv 夷 行 時には ginit が 必要 

12: screen(l); 

13: ldirmvCdata, T32CGP + ，A, * 8, 8); 〜•• フォント 
14: を统み 込む 

15: for (i = 0; i < 8; ++i) { 
16: for (j = 0; j < 8; ++j) { 

17: if C(data[i] k 0x80) « 0) 左端 ビッ ト 

18: putchar(' ，）； は 0 か？ 

19: else 
20: put char ('A'); 

21: data[i] «= 1; data[i] を 左に シフト 

22: } 

23: put char (^nO; 

24: } 

25: 

26: getchO; 
27: screenCt?;; 
28: } 



リスト 3.16 し DIRMV.C 



71 



3 章 特製 ライブラリ 関数の 説明 



きへ fhvrm 関数 



【機能】 VRAM 上の 連続 範囲 を 一定の データで 埋めます （ ginit () が 必要) 

【仕様】 include <msxalib.h> 

VOID filvrm (ad， In, dt) 

unsigned ad; VRAM ァ ドレス 

unsigned In; 書き込む 長さ 

char dt; 書き込む データ 



園】 

第 1 バラ メータ ad が 示す VRAM ァ ドレスから， 第 2 パラメータ In が 示す 長 
さ だけ， 第 3 パラメ一 タ dt が 示す デ一 タ で VRAM を 埋めます. 

【用例】 

SCREEN 5 で 特殊効果 的 な 画面 消去 をお こない ます. 

プログラムの 最初に 定義して いる erase 閼数 は， SCREEN 5 の 画面 上で， 
8 行お きの 0,8,16, • • *, 208 の 各 ラインに 相当す る VRAM に データ 0 を 書 
き 込みます. しばらく 待機して から， その 1 つ 下の 系列 1,9,,17, • • .,209 の 
各 ライン を 消去して いきます. これ を 8 回 繰り返す ことで， 画面 はすべ てク 
リアされ ます. 
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3. 1 特製 ライブラリの 全 関数 



# include <stdio,h> 
# include <DL8xalib.h> 



2: # include <msxclib.h> 

3: 

4: VOID eraseO 

5: { 

6: int i, j ； 

8: for (i = 0; i <- 7; ++i) { 

9: for (j = i; j <= 2U; j 8) 

10: filvrmCj * 128, 128, (char)0); ♦ グラフィック 

11： for (j = 0; j < 7000; 画面 は 必ず VIUM 

12: } 0 番地から 始まる 

13: } ため J(*i28 に は 

14: 何も 加えなくて 

15: VOID mainO よい 
16: { 

17: int i; 
18: 

19: ginitO ； filvrm 実行時に は ginit が 必要 

20: smdO; 

21: color(15, 1, 1); 

22: screen (&; ； 

23: for (i = 0; i <= 4«l; ++i) 

24: boxfil(rnd(256) > md(212),rnd(256) > rnd(212),rnd(15),0); 

25: for (i = 0; i < 30000; 

26: era.8e() ； 

27: for (i = 0; i く 30000; 

28: screen(0) ； 

29: } 



リスト 3.17 FILVRM.C 
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3 孝 特製 ライブラリ 関数の 説明 



snsmat 関数 



【機能】 押された キー を 即座に 読み取ります 

【仕様】 #include <msxclib. h> 
TINY snsmat (mt) 

int mt; …… 読み出す キ 一マ ト リ タスの 行 

【説明】 

MSX-C 標準 ライブラリに は， getch 関数， getche 関数， gets 関数の 3 つの 
文字 入力 用 関数が 用意 さ れ ています. これら の 関数 は 非常に 有効な 関数です 
が、 タイマー 割り込み 禁止 中 は 使用で きません し， キーボード バッファに 保 
存 される ために タイム ラグが ある （つま り 以前 押した キーで まだ 読み取って 
いない もの を 現在の キー入力 と して 読み込んで しま う） などと いう 欠点 を 持 
つてい ます. 

そこで 登場す るの が この snsmat 関数です. この 関数 は， MSX BIOS の 0141 
h を コールす る ことで 実現して います. 

MSX は キー入力の 有無 を 確認す るた めに 図 3.9 のよ う なキ一 マ ト リ クス 
を 用います. 読み出す キ一 マト リ クスの 行 を パラメータ として この 関数に 引 
き 渡す と， その 行の 現時点の 状態が TINY 型の データと して 戻って きます， 押 
されて いる キーに 対応した ビット は 勺〜 押されて いない キーに 対応した ビ 

ッ トは 、、r になります. 

AND 浪算子 「& 」， OR 演箅子 「 | 」， ビット シフ ト 演算子 「>>」 な ど を 利用 
すると， 今 現在 どの キーが 押されて いるかの 判定が できます. 複数 キーが 同 
時に 押されて いる こと も 判定 可能です. 

【用例】 

移動す るス プライ ト 力つ STOP キー を 押す と 停止し， もう一 度 STOP*— を 
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3. 1 特製 ライブラリの 全 関数 
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図 3.9 キー マトリクス 



柙 すと 再び 動き 出します. リ ターン キ一 を 押す と プログラム は 終了し ます. 

STOP キー は キー マト リ タスの 7 行め のビッ ト 4 に 対応して いますから， 
snsmat (7) と 0x10 の ビットごと の 論理 積 (AND) をと つて， それが 0 なら 
ば 押されて いると 判断で きます. 

プロ グラムの 最初で 定義して いる stop 関数 は， STOP キ一 が 押された 瞬間 
を とらえる ものです. 「STOP キーが 押された 瞬間」 というの は， 「前に STOP 
キーが 押されて いず 今 は 押されて いる」 状態です. stop 閼数 では， まず 現在の 
STOP キーの 状態 を 調べ， それ を 変数 s に 記録し ます （押されて いれば 1， 押 
されて いなければ 0) . 前 II の STOP キーの 状態 は 変数 old_s に 記録して ありま 
す. そこで 「s && ！ old_s」 という 条件 を 調べる と 「キーが 押された 瞬間 j が 
わかる わけです. 

main 関数で は， スプ ライト を 左から 右に 動かし， STOP キーが 押される と 
それ を 止め， も う 一度 STOP キーが 押される ま て 1# ち ま す. プロ ダラ ム を 終了 
させる のはリ ターン キーです が， これ は キー マト リ タスの 7 行め のビッ ト 7 
に 対応して いますから， snsmat (7) と 0x80 の ビットごとの 論理 積 をと る こ 
とで 判定で きます， 
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3 章 特製 ライブラリ 関数の 説明 



» include <stdio.h> 
# include <mBxclib.h> 

char Ptspr0 [32] = { 

0x0f , 0x3f , 0x63 , 0x41 ,0x41, 0x41 ,0x63, 0x7f , 
0x4f ,0xle, 0x01 , 0x07 Jx00 9 0x00 Jx00, 0x00 , 
0xc0 ,0xg0, 0xf0 , 0xf 0 ， 0xf8 , 0xfS , 0x78 , 0x78 , 
0x78 , 0xf0 ,0xf4, 0rf4 , 0xf 6 , 0x6e ， 0x3e , (9x1 c ] 



char Ptsprl [32] = { 

0x00,0x00,0x00,0x00 
0x00,0x00,0x00,0x00 
0x00,0x00,0x00,0x00 

char Ptspr2 [32] = { 

M0Jx00, 0x00 ,0x00 
0xfc,0xff ,0xf7,0xfb 
0xH0 Jx00 Jx00 J x 00 
0x7c,0xbe,0xde,0x<ie 



, 0x18,0x18,0x00,0x00 , 
Jx07, 0x07, 0x03 ,0x01, 
Jx00Jx00Jx0tJx00, 
Jx00Jx80Jxc0Jxe0 ) 



, Mi, 0x3f , 0x7f , 0xff , 
,0xfb,0x7b,0x77》0x3f, 
,0x80,0xe0,0xf8,0xfc, 
, 0xde , 0x6e , 0x5e , 0xbc }; 



TIMY stopC) 

static TINY old.e = 0； 
TINY s, r; 

s = ((snsmat(7) ft 0x10) 
r = (s ftfc ！ old 一 s); …- 

Old— B = 8； 

return r: 



'- static なので 次の 
呼び出しまで ffl が 残る 

0)； …一 STOP は 
今 押された ところ か 



VOID main() 
{ 

char x a 

int i: 



colorClS, 1, 1)； 

screezi(l); 

ini8pr(2); 

sprite (U, PtaprjJ) ； 



345678901 



1^234567890l23456789^1-^^^-^^r:^hh 
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3. 1 特製 ライブラリの 全閱数 



41: aprite(4 > Ptsprl); 

42: sprite(8, Ptspr2); 
43: 

44: while ((snsmat(7) k 0x80) != (J) { -… RETURN? 

45: if (stopO) { 

46: putspr(0, x, 150, 4, 8); 

47: putsprCl, x, 216, 0, 0); 

48: while (！ stopO); 

49: } 

50: x -= 2; 

51: putspr(J), x, 150, 4, 0); 

52: putsprCl, x, 150, 15, 4); 

53: for (i = 0; i < 2000; ++i) ; 

54: } 

S5: 

56: screen(0) ； 
57: } 



リスト 3.18 SNSMAT.C 



3 章 特製 ライブラリ 関数の 説明 



Mlbuf 関数 



き.: ■':、..： ' 



ゝ^ i?^ 



■PI 



【機能】 キー バッファ をク リアし ます, 

【仕様? #include く msxclib. h> 



VOID kilbuf () 



mm] 

キ一 ボー ドか らの 入力 は タイ マー 割 り 込みで 1/60 秒 毎に キー スキャン さ 

れ， その 文字コードが キ 一バッファに 格納され ていきます. kilbuf 関数 は， こ 
の キー バッファに 格納され ている データ をす ベて ク リアす る 関数です. この 

閧奴 は， MSX BIOS の 0156h を コールす る ことで 実現して います 
【用例】 

キー バッ フ ァをク リアして， キ一 バッファに たまつ た 不要な 文字が 画面に 
表示され る こと を 防ぎます， 

この プログラム を 実行す る と ， 「 T y pe some words ./ 」 という メ ッ セージ 
を 出力し ます, こめ メ ッ セージの 出力 中に いろいろ キー を 押し， 最後に リ タ 
ーン キー を 押して プログラム を 終了 させて ください そして MSX _ D0S に 戻 

つても， 画面に はなん の 文字 も 表示され ません. これが kjlbuf 関数の 効果で 
す • 

といっても 理解 しづら いでし ようから， こんど は 「 knbuf () ; 」 を 削除し 
て コンパイルし， 同様に 実行して みて ください.， すると， MSX _ D0S に 戻つ 
た 瞬 問に， それ ま でに 入力 し た キー データ 群^ 画 面に ド ッ と 表示され た と 思 
います. このよ う な こ と を 避ける ために 使 う のが kilbirf 関数です. 



78 



3. 1 特製 ライブラリの 全 関数 



# include <stdxo , h> 
# include <msxclib.li> 



VOID mainC) 
{ 

5: puts ("Type some words ! ¥n n ) ； 

6： putsC" and hit [RETURN] key to exit.¥n M ); 

while ((snsmat(7) k 0x80) !« 0); …- RETURN 待ち 

8： kilbufO; これで キー バッファが ク リアされ る 

9： } 



リスト 3.19 KILBUF.C 



ト リ ガ 一ボタ ンで ミ サイ ルを 連射す る 



GTTRIG.C(p.83) の 実行 画面 
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3 帘 特製 ライブラリ 問 数の 説明 



gtstck 関数 



【機能】 ジョイ ス ティ ックの 状態 を 読み取り ます 
【仕様】 #include く msxclib, h> 
TINY gtstck (no) 

int no; •••••• ジョイ ステ イツ ク 番号 

【鋭 明】 

ジョイ ス ティ ック 番号で 指定した 装置 （ジョイ ス ティ ック あるいは カー ソ 
ル キー） の 押されて いる 方向 を 調べます. この 関数 は， MSXBIOS の 00D5 
h を コールす る ことで 実現して います. ジョイ ス ティ ック 番号と 装置の 対応 
は 以下のと おりです. 

0 ： カーソル キー 

1 ： ジョイ ス ティ ック 1 

2 ： ジョイスティック 2 

押されて いる 方向 は， 0〜8 の TINY 型の 値と して 返されます. その 展り値 
と 方向の 対応 は， 図 3.10 に 示す とおり です. 

【用例】 

カーソル キー または ジョイ ス ティ ックの 操作に 応じて， 戦闘機 を 移動 させ 
ます. ジョイスティック は ポート 1 に 接続され ている ものと します. リタ— 
ン キー を 押す と プロ グラム は 終了 します. 

move 関数 力す 戦闘機の 実際の 移動 処理と なります. gtstck(O) は カーソル キ 
一の 状態 を 読み取り， gtstck (1) は ジョイスティックの 状態 を 読み とりま 
す， どちら か は 常に 0 になる はずです から， 両者の ビッ ト ごとの 論理和 (OR) 
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3. 1 特製 ライブラリの 全関數 




をと ると， 「カーソル キー または ジョイ ス ティ ッ ク J の 状態が 得られます. 

さて， このよう にして 得られた 移動 方向から， 配列 Xtrns [] と Ytrns[] 
を 参照して， x 方向， y 方向の 移動 量 を 決めます. たとえば 移動 方向が 1 のと 
き は 上方 向への 移動 を 意味して いるので すから， Xtrns[l] は 0, Ytrns [1] 
は- 64 と してお く わけです. これら を x， y 座標 それぞれ に加え 戦閿 機の スプラ 
ィ ト を 表示す ると 戦闢 機が 移動し ます. 



0： # include <stdio ,h> 
1: # include <msxclib.h> 

2: 

3: char ptspr0 [32] = { 
4: 0x00, 0x03, 0x03 
5: 0x3c, 0x35, 0x75 
6: 0x80, 0xc0, 0xc0 

7: 0x3c, 0x2c, 0x2e 

8: 

9: int Ytrns [9] = { 0,-64,-45, 0, 4B, 64, 45, 0,-45 

10: int Xtrns[9] = { 0, 0, 45, 64, 45, 0,-45,-64,-45 
11: 

12: VOID moveO 

13: { 

14: static int 
15: static int 
16: int i; 



0x13, 0x13, 0x16, 0x14, 0x3d, 

0x75, 0x7c, 0x7e, 0x77, 0x33, 

0xcS 9 0xc8, 0x68, 0x28, 0x3c, 

0x2e, 0x3e, 0x7e, 0xee, 0xcc 



X = 120 * 64; 座標 はすべ て 64 倍 

y = 120 * 64; して、 精度 を あげる 
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3 章 



特製 ライブラリ 関数の 説明 



} 



i - gtstck(0) I gtstck(l); ―" カーソル キー または 

ジョイスティック 

x += Xtrns [i] ； 

if (x >- 225 * 64) 

x = 224 * 64; 
else if (x < 16 * 64) 

I = 16 * 64; 

y += Ytrns [i] ； 

if (y >* 165 * 64) 

y = 164 * 64; 
else if (y < 28 * 64) 

y = 28 * 64; 

putspr(0, x/64, y/64, 15, 0); 表示 時に 座標 

を 1/64 とする 



VOID mainO 
{ 

int i: 



1); 



color(15, ： 
screen(l); 
inispr(2); 
sprite(0, ptBpr0); 
while ((snsmat(7) k 0x80) != 0) 
move O J 

for (i = 0; i < 500; 

color(15, (J, 0); 
screenC0^ ； 
kilbufO- 



リスト 3.20 GTSTCK.C 



7 8 9 0 12 3 45678901234*5678901234 

111222222222233333333^34^^"^^ 



5 

4 



0 

5 
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3. 1 特製 ライブラリの 全閱数 



gttrig 関数 



【機能】 ト リガ 一 ボタンの 状態 を 調べます 

【仕様】 #include <msxclib. h> へッ ダー • フ アイ ノレ 

TINY gttrig (no) 

int no; •••••• ジョイ ステ イツ ク 番号 

【锐 明】 

第 1 パラメータて ^ 定 した 装置 （ジョイスティック あるいは マウス） のト 
リガ 一 ポタン， または スペース キーが 押されて いるか どうか を 調べます. こ 
の 関数 は， MSX BIOS の 0OD8h を コールす る ことで 実現して います. 

押されて いると き は 1, 押されて いなかった とき は 0 の TINY 型の 値が 返 
されます. ジョイ ス ティ ック 番号と 装置の 対応 は 以下のと おりです. 

0 ： スペース キー 

1 ： ジョイスティック 1 のト リガ 一 ボタン 1， マウス 1 の 左 ボタン 

2 ： ジョイ ス ティ ック 1 のト リガ 一 ボタン 2， マウス 1 の 右 ボタン 

3 ： ジョイ ス ティ ック 2 のト リガ一 ボタン 1， マウス 2 の 左 ポタン 
4: ジョイスティック 2 の トリガ一 ボタン 2， マウス 2 の 右 ボタン 

【用例】 

ト リガ一 ボタン， または スペース キー を 押す と 戦闘機から 弾が 発射され ま 
す • 5 発の 連射が 可能です が， ト リガ 一 を 押し 続けて いると かえって 遅く なる 
ように 工夫して あります. リ ターン キー を 押す と プログラム は 終了し ます. 
なお， ジョイ ス ティ ックを 使用す る 場合 は ポート 1 に 接続して ください. 

グロ一 バル 配列 変数 Ypos[] は 5 発の 弾の y 座標 を 表し， この 値が 255 のと 
き は 画面 上に 出現して い ない 未使用 の 状態 を 示します. 
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3 窣 特製 ライブラリ 閱 数の 説明 



beam 関数 は， 5 つの 弾す ベての 移動 処理 をお こない ます， 画面 上に 出現し 
ている 弾 （y 座標の 値が 255 でない 弾） は， 常に 2 ドッ ト ずつ 上昇 を 繰り返し 
ます. 弾の スプ ライト は Ypos[] の 座標から 15 を 引いた 座標に 表示し， たと 
え ば y 座標が 0 のとき 実際に 表示され る 位 S は- 15, つまり ほんの わずか シ ッ 
ポが 見え ると いう 状態に な る わけ です. 

弾の 出 MM 理は shot 関数が おこないます. ト リガ 一力 《 押 される と， 未使用の 
弾 を 探し， その y 座標 を 発射 地点の 182 とします. あまり 一度に 弾が 発射され 
ないように， この 関数 は wait という 変数で 発射 間隔 を 管理して います. 弾 を 
発射した 直後 は wait の 値 は 36 です. そして トリガー を 押して いないと き は 
wait は 4 ずつ 減って いき， トリガ一 を 押してい ると 1 ずつ 減って いき， これ 
が 0 になる と 次の 弾が 発射で きる ようになります， これによ つて， 押しつ ば 
なしにして いると きよりも， 適度な 間隔で 押し 直した ほう が 効率の よ い M 
になる という 機能が 備わります. 



t include <8tdio.h> 
# include <msxclib.h> 

char Ypos [S] ； 

char Ptspr^ [32] = { 
0X01, 0x13, 0x13, 
0xfc, 0rf4, {5xb4, 
0x80, 0xc8, 0xc8， 
0xbf , 0xaf, 0x2d, 

char Ptsprl [32] = { 

Ml, 0x03, 0x03, 

Ml, 0x02, 0x01, 

0x80, 0xc0, 0xc0 # 

0x00, 0xc0, 0x00, 

VOID be&m() 
{ 

irtt i: 



for (i = 0; i く- 4; { 
it (Ypos[i] •= 255) < 
YposCi] -= 2; 
if (Ypoe[i] < 212) 

putsprCi, 120, Ypos [i] -15, 10, 4); 
else { 

Ypos [i] = 255; 

0, 217, 0 P 0); 



0x37, 


0x37, 


0x76, 


0x74, 


0x54,, 


0xb4, 


0xb©, 


0xf7, 


0xf7, 


0x63/ 




0X6 


0x6e, 


0x2« v 


0xaa f 


0xad, 


0x7d, 




0xef , 


0xc6 >; 


0X03, 


0x03, 


0103, 


0x01, 


M2 9 


0x00, 


0x01, 


0X00, 


0x01, 


0x00, 


0xc0, 




0xc0, 


0xc0, 


0xc0, 


"80， 


0X00, 


0x80, 


0x0^ 


0x80 h 
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3. 1 特製 ライブラリの 全 関数 



VOID BhotO 
{ 

int i; 

static int v&lt = P; 

if ((gttrig(JJ) I gttrig(D) »• 0) { 
wait -= 4; 
if (wait < 0) 
v&it = 0； 

> else { 
-- wait j 

if (wait < 直 0> { 
wait = 36; 

for Ci * 0; i <= 4; ++i> { 
if (YpoeCi] == 255) < 
Ypos [i] - 182; 
break; 

} 



スペース キー も 
卜 リガ 一 ボタン も 
押されて いない 



> 



} 



} 

VOID mainO 
{ 

int i; 

color(15, 1， 1); 
screen(2) ； 



sprite (0, Pt8pr0); 
sprite(4, Ptsprl); 
putsprCB, 120, 170, IS, 0); 
for (i = 0; i <= 4; ++i) 
Ypos[i] = 255; 



while C(snsmat(7) 
shotO; 
beanC); 
for (i - 0; i 

} 

scr«en(0; ； 
kilbufO; 



0x80) != 0) { 
150; 



リスト 3.21 GTTRIG.C 



901231-567890123456789012345678901234S6789012345678 

23333333333444444444455S5S5S5556666666666777777777 
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3 章 特製 ライブラリ 閲 数の 説明 



gtpad 閱数 



【機能】 マウスの 情報 を 読み取ります 

【仕様 j #include く msxclib. h> 

int gtpad (no) ； 

int no; …一 装置 ID 

【説明】 

指定した パラメータ no の 値に より， マウスの 各種の 状態 を 調べます. この 
関数 は， MSX BIOS の OODBh を コールす る ことで 実現して います. したがつ 
て， バラ メータの 値と 得られる 情報の 対応 は 表 3.7 に 示す とおりです. 

【用例】 

この プログラム は マウス を ポート 1 に 接続して 実行して ください. 左 ボタ 
ンを 押しながら マウス を 動かす と 画面に 線が 引かれます， 右 ボタン を 押す と 



12 
13 
14 
16 
17 
18 



に^ zir~ 



ポート 1 の マウスの 入力 要求 をお こなう 

ポート 1 の マウスの X 座標 移動 量 を 得る （一 128〜+127) 
ポート 1 の マウスの Y 座標 移動 景を 得る （一 128 〜十 127) 
ポート 2 の マウスの 入力 要求 をお こなう 
ポー 卜 2 の マウスの X 座標 移動 量 を 得る （-128 〜十 127) 
ポート 2 の マウスの Y 座標 移動 量 を 得る （一 128 〜十 127) 



注： no に 13, 14( あるいは 17， 18) を 指定して 座標 條を 得る 場合 は， 予め 
no に 12 (あるいは 16) を 指定して 関数 を 呼び出す ^があります， 
表 3,7 gtpad 関数で 得られる 情報 
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3. 1 特製 ライブラリの 全 関数 
画面 をク リアし ます. リターン キー を 押す と プログラム は 終了し ます. 

mouse 関数 は カーソルの 移動 をお こない ます. まず gtpad (12) で 入力 を 要 
求し， x 座標， y 座標 それぞれの 移動 量 を gtpad (13), gtpad (14) で 読み取り 
ます， これ を 現在の 力一 ソ 置 Cx, Cy に それぞれ 加えれば， 新しい 力一 ソ 
ノ 置が 計獰 できます. 



1： 
2: 
3: 

S: 
6: 

8: 
9: 
10： 
11: 
12: 
13: 
14: 
15: 
16: 
17: 
18: 
19: 
20: 
21: 
22: 
23: 
24: 
25: 
26: 
27: 
28: 
29: 
30: 
31: 



ft include <staio.h> 
# include <msxalib.h> 
# include <msxclib.h> 

char Spr [8] = { 

0xfc, 0x10, 0xf8, txfc, 0xbe, 0x9f , 0x0e, 0x04 }j 

char Col [8] = { 

40, A0 t 40, 40, 40, 401, 40， 40 }; 

int Cx = 128; 
xnt Cy = lfii6; 

VOID mouse () 

gtpad ひ 2); マウス 入力 要求 

Cx += gtpad(13); x 座 « の 読み取り 

Cy gtpad(14); y 座 擦の 読み取り 

if (Cx < 8) Cx - 8; 

if (Cx > 240) Cx - 240; 

if (Cy < 8) Cy = 8; 

if (Cy > 200) Cy = 200; 
putspr(0, Cx + 1, Cy, 0, 



VOID drawO 
int x, j 
do { 



Cx; 

cy; 
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3 窣 特製 ライブラリ 関数の 説明 



32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 



mouse () ； 

if (gttrig(D) 左 ポタン は 19 を 描く 

line(Cx, Cy, x, y, 15, 0); 
if (gttrig(3)) 右 ポタン は 画面 ク リア 

filvrm(0, 0x6a00 > 0); 
} while ((snsmat(7) k 0x80) != 0); 



VOID mainO 



1)； 



ginitO ； 
color(15, 
screen(S) ； 
ini8pr(0) ； 
sprite(0, Spr) ； 
colspr(0, Col); 
drawO; 



kilbufO; 



リスト 3.22 GTPAD.C 



VRAM 操作 は MSX を 扱うた めの 基礎 技術 



つ； ゥっゥ 

m 

么ェ ニム 么 



クウ 今^今 
ゥゥゥ 今今 
ク クラ クク 



？ CT? つ.？？？？？，？？？？？ cr ？ つ，？？？？？ つ. 

？?? ？?? ？?? ？?? ？?? ？?? ？？? ？ 



ク .cf ク ク， 

？?? つ.？？ 

ク ク * ゥ .{V ，ク. 

園- ゥ ク無 

？? つ-??? 

？っ う-??? 

？? rrcf? つ- 

^*_?？ づ. つ ♦? 

？ゥ， ？-ゥ 

crfrcr? つ-？ 



C ，つ. つ •ticrcr 

マ？？？？？ 

?????? 

？?? ？ ク.？ 

？ つ.？ cf つ *? 

つ，？？ 1ゥ う. 

ゥ|ゥ ，國 *暑ゥ1ク義 

????? 

cytf ク.？ 7 

？ゥ 

ク. v?9-licr 



？? ゥ令 9 今 

つ. fr??cf? 

？ ゥ.？ -ゥク 
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VP0KE.C(p.64) の 実行 画面 



3. 1 特製 ライブラリの 全閼数 



gicini 関数 



【機能】 PSG の 初期 ィ匕 をお こない ます 
【仕様】 お nclude <msxclib.h> 
VOID gicini () 

【説明】 

PSG を 初期化す る ことができます. このと き PSG の レジスタ は 表 3.8 のよ 
うに 設定され ます. この 関数 は， MSX BIOS の 0090 h を コールす る ことで 実 
現して います. 

【用例】 

sound 関数の 項 を 参照して く ださ い. 





，' 内ぐ ' 容 r) 




0 


チャンネル 1 周波数 


55 h 


1 


00 h 


2 


チャンネル 2 周波数 


00 h 


3 


00 h 


4 


チャンネル 3 周波数 


00 h 


5 


00 h 


6 


ノイズ 周波数 


00 h 


7 


チャンネル 設定 


68 h 


8 


チャンネル 1 音量 


00 h 


9 


チャンネル 2 音量 


00 h 


10 


チャンネル 3 音量 


00 h 


11 


エンベロープ 周期 


OBh 


12 


00 h 


13 


エンベロープ パ、 ターン 


00 h 



表 3.8 PSG レジスタの 初期値 
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3 章 特製 ライブラリ 関数の 説明 

sound 関数 

【機能】 効果音 を 発生させます 

【仕様】 #include <msxclib. h> 

VOID sound (rg, dt) 

int rg; •• •• PSG の レジス タ 番号 

int dt; …… 書き込む データ 



議 3 

MSX の 音楽 機能と して PSG (Programmable Sound Generator) という 
LSI が 標準 装備され ています. この 関数 は， MSX BIOS の 0093 h を コールし 
て， PSG を 直接 操作す る ことで 音 を 出して います. 

PSG に は 3 チャンネルの トーン ジェネレータと ボリ ュ一ム コント ロール 
ァ ン プがぁ り， それ ぞれ 独立 してい ますので， 1 つ 1 つ 個別 に 音程 と 音量 を 指 
定 できます. また ノイズ ジェネレータ および エンベロープ ジェネレータ も備 



トーン 周波数 



t チャンネル D 
l チャンネル 2 ) 

L チャンネル 3) 



ジ膽 Hi^j^i 



P^P H 攀綱 



ノイズ 周波数 



( _ /ィズ ） P ジス ■ 



エンベロープ 周波数 



ミキサー 




エンベロープ パターン 



f ェンべ D — ブ：) i^mm^^M^M 



図 3,11 PSG の ブロック ダイヤグラム 
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3. 1 特製 ライブラリの 全 関数 

えてい ますが， 各々 1 つし か 存在して いないた めに， これ は 各 チャンネルで 共 

用し ます. 図 3.11 はこの よう な PSG の 仕組み を 表す ものです. 

PSG は 14 個の レジスタ を 持ち （他に 2 個の レジスタが ある が、 音の 発生 と 
は 無関係 なので 説明 は 省略)， そこに データ を 鄯 き 込む こと で 動作が コント 口 
—ル されます. PSG レジスタの 構成 は 図 3.12 のように なって います. 

• レジスタ 番号 0〜5 

チャンネル 1, 2, 3 の 音の トーン 周波数 を 指定し ます. トーン 周波数 は 12 
ビッ トの データです. 表 3.9 は 標準 的な 音階 を 発生させる ための レジスタ 設 
定 値です. 



8 
9 

10 
11 
12 
13 



.765 


4 


3 2 10 




下 1 


卒 1 . . 




. 上位 1 . 




下 1 


S2 . . . 


: v 、'； おん』,: 1 、， 




. 上位 2. 




T1 






籍:: 


： き： 




ノイズ . 


0 | 0 |N3 


N2 


N1|T3 T2 IT1 




E1 


. 音 S1 . 




H2 


. « 量 2. 




E3 


日. ま <5 . 


. . . T1 




. . . 上 1 


[4E . , . 




2^ 


塵 mv<, 



(ビッ ト） 
== チャンネル 1 トーン 周波数 

[上位 2| せ 位 2| 

= チャンネル 2 トーン 周波数 
「上位 3レ「 下位 3】 
= チャンネル 3 トーン 周波数 
ノイズ 周波数 
チャンネル 別 ミキサー 
チャンネル 1 音量 
チャンネル 2 音量 
チャンネル 3 音量 
[上位 eJ+I 下位 E] 
= エンベロープ 周波数 

エンベロープ バタ一 ン 



Tl、 T2、 T3 ト一ン の チャンネル 別 スィッチ 

NU N2、 N3 …… ノイズの チャンネル 別 スィッチ 
El、 E2、 E3 エンベロープ チャンネル 別ス イツ: 



囟 3*12 PSG レジスタの 構成 
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3 荦 特製 ライブラリ 関数の 説明 



働く 
：喊: ： 

麵 

.£•>•....；• 

顏る: 
聰:: 



Gf" 

翁 •: 

謙 i 

.;に;ぐ三ソ 



D5Dh 
C9Ch 
BE7h 
B3Ch 
A9Bh 
A02h 
973h 
8EBh 
86 Bh 
7F2h 
780h 
714h 



6AFh 
64Eh 
5F4h 
59Eh 
54Eh 
501h 
4BAh 
476h 
U6h 
3F9h 
3C0h 
38Ah 



357h 
327h 
2FAh 
2CFh 
2A7h 
281h 
25Dh 
23Bh 
21Bh 
lFDh 
lEOh 
lC5h 



lACh 

194h 

17Dh 

168h 

153h 

140h 

12Eh 

HDh 

lODh 

FEh 

FOh 

E3h 



D6h 
CAh 
BEh 
B4h 
AAh 
AOh 
97h 
8Fh 
87h 
7Fh 
78h 
71h 



6Bh 
65h 
5Fh 
5 Ah 
55h 
50h 
4Ch 
47h 
43h 
40h 
3Ch 
39h 



35h 
32h 
30h 
2Dh 
2Ah 
28h 
26h 
24h 
22h 
20h 
lEh 
ICh 



lBh 

19h 

18h 

16h 

15h 

14h 

13h 

12h 

llh 

lOh 

Fh 

Eh 



表 3.9 トーン 周波数 一 K 



• レジスタ 番号 6 
ノ ィ ズ 周波数 を 指定し ます. ノ ィ ズ 周波数 は 0 から 31 の 数値です. 

• レジスタ 番号 7 

各 チャンネルから 音 を 出す かどう か を 指定し ます， にの レジスタ は 図 3.13 
のように ビットが 割り当てられ ています. そして， 各 ビットが、、 0 ケ のとき， 
その ビッ ト に 対応す る トーン あるいは ノイズが 出力され ます. 



• レジスタ 番号 8，9,10 

チャンネル 1， 2， 3 の それぞれの 音量 を 指定し ます. 音量 は 下位 4 ビット 

の データで o から 15 まで 変化 させられます. また ビット 4 を 、、r とする こ 

とで， 音景を エンベロープの 波形に 合わせて 変化 させられます. ェン ベロー 
プを 使用 するとき は 音量の 指定 は «ft されます. 



ず ： 

-ぉ.ゃ„ りつ 

も 一 い 



い 1^ 

難 



ゾ へ.，：、 , 

き. 



.4 -、 



入： ーヒ 



名 

0 
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3. 1 特製 ライブラリの 全 関数 



2 1 0 (ビッ ト） 



レジスタ 7[ 0 ] 0] N3[N2fNl|_T3] T2[ Tl 



いずれも 



0 ならば 出力す る 
1 ならば 出力し ない 



チャンネル 1 トーン 出力 
チャンネル 2 トーン 出力 
チャンネル 3 トーン 出力 
チャンネル 1 ノイズ 出力 
チャンネル 2 ノイズ 出力 
チャンネル 3 ノイズ 出力 



図 3.13 各 チャンネルの 出力 選択 



データ 


ェン ペロー ブパ ダーク 


データ 


ェン ペロー 汐バダ 一 ン 


0〜3，9 


N 


11 


N 


4〜7,15 


A 


12 




8 




13 


Z 


10 




14 





図 3, 14 エンベロープの 波形の 設定 



• レジスタ 番号 11,12 

エンベロープの 周波数 を 指定し ます. エンベロープ 周波数 は 16 ビッ トのデ 

ータ です. 
• レジスタ 番号 13 

エンベロープ パターン を 指定し ます. エンベロープ パターン は， 図 3. 14 の 
とおりです. 
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3 章 特製 ライブラリ 関数の 説明 



【用例】 

ヘリ コプ ターの 音 を 発生させます. 何 か キー を 押す と 音 は 止ま り ます. 

チャンネル 1 から 2000 Hz の トーンお よび 3800 Hz の ノイズ を 出力し， さ 
らに エンベロープ パターン 12 を 周期 300 Hz で 使用し ます. このよ う な 設定 
により 疑似 的に ヘリ コプタ の 音 を 発生 させて います. 

プログラム 終了の 前に gicini 関数 を 実行して いますが， これ は 音 を 止める 
ための いちばん 手軽な 方法です. 



2: 
3: 

5: 
6: 

8: 
9: 
10： 
11: 
12: 
13: 
14: 
15: 
16: 
17: 



# include <stdio.h> 
# include <msxclib.h> 

VOID mainO 

static int d&tapsg [14] = { 

55, 0, 0 y 0, 0, 0, 29, & 4, 

16, 0, 0, 116, 1, 12 }; 
int i; 

giciniO; PSG の 初期化 

for (i = 0; i < 14; ++i) 

sound(i, datapsgti]); 14 ffl の レジスタ を 設定 

getchO; 

giciniO; 啻を 消して 終了 



リスト 3.23 SOUND. C 
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3. 1 特製 ライブラリの 全 関数 



caibio 関数 



【機能】 MSX の ROM-BIOS の 機能 を 呼び出 します 
【仕様】 #include く msxalib. h> 
VOID caibio (ad, rg) 

unsigned ad; BIOS コ 一 ル 先の ァ ドレス 

regs *rg; regs 構造体への ポインタ 

【刚 

caibio 関数 は BIOS を 呼び出す 関数です. MSX は， たとえ 機種が 異なって い 
て も， ある いは ハー ドウ ヱァ の 変更 や 機能 拡張が お こな われた としても， 
「BIOS」 と 呼ばれる 入出力に 関する サブルーチン を 利用す る 限り， 問題な く 
作動で きる よう に 互換性が 保 たれて います. 

caibio 関数の 第 2 パラメータ は， Z 80 CPU の レジスタ を 示す regs 型の 構造 
体への ポインタです. この regs 型の 構造体 は f, a, be, de， hi という 名の 4 つ 
の メンバ一 で 構成 され， そ れぞれ 同名 の CPU の レジスタに 対応して います. 
構造体 regs はへ ッ ダー ファイル や msxalib. h〃 内で， 以下の ように 定義され て 
います， 



struct regs { 
char 
char 

unsigned 
unsigned 
unsigned 



. > c e ^ 

f， r'b dL 
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3 隶 特製 ライブラリ 関数の 説明 

この regs 構造体に 値 をセッ ト して calbio 関数 を 呼び出す と， 各 レジスタに 
値が 引き渡されて BIOS;^ 実行され ます. また， 関数 実行 後に regs« 造 体 を 調 
ベる と， BIOS 呼び出し 終了 時点の レジスタの 値が わかります. 



【用例】 

capsori 関数 は CAPS キーの ランプ を 点灯し， capsoff 関数 は CAPS キーの ラ 
ンプを 消します. そして， これらの 関数 を 交互に 適当な 間隔 をお いて 呼び出 
す こ と で， 点滅 を させます. 残念ながら CAPS キーの ランプが 取り付けられて 
いない MSX では， この 動作 を 確認す る こと はでき ません， あしからず. 



2: 
3: 

5: 
6: 

8: 
9: 
10： 
11: 
12: 
13: 
14: 
15: 
16: 
17: 
18; 
19: 
20: 
21: 
22: 
23: 
24: 
25: 
26: 
27: 
28: 
29: 



# include <stdio.h> 

# include <msxalib,h> struct regs 構 進 体 はこの 

フ アイ ルの 中で 定 糠され ている 

VOID capsonO 
{ 

struct regs r; 

r,a = t; A レジスタに 0 を 入れて 

calbio(0x0132, ftr) ； 01321i 番地の BIOS を コール 

} 

VOID capsoff () 
{ 

struct regs r; 

r.a = 1; A レジスタに 1 を 入れて 

calbio(0x0132, &r) ； 0132h 番地の BIOS を コール 

} 



VOID mainC) 
{ 

int i, j ； 

for (i = 0; i < 10; ++i) { 
capaonO; 

for Cj ^ 0; j < 2mt\ ++j); 
capsoff () ； 

for (j = 0； j < 20000; 



リスト 3,24 CALBIO.C 
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